UT2T88 Rev 1.00 documentation ------------------------------- - copies talkgroup names and radio names from UniTrunker files to TRUNK88 files under user control - optionally copies UniTrunker talkgroup and radio: - colors - priorities - timestamps - comms counts - UT2T88 is designed for users who want to: - copy ID names from their own UniTrunker files to their TRUNK88 files, e.g. just copy everything. - copy/merge someone elses UniTrunker files (from a web site, etc.) to their own TRUNK88 files with some control, so you can choose what data to add to your TRUNK88 files. ---------------------------------------------------------------------------- - command line format: UT2T88 [options] UniTrunkerPath\SysID TRUNK88Path\CtlFileName Options: - /COLOR - copy UniTrunker talkgroup and radio colors - /PRIORITY - copy UniTrunker talkgroup and radio priorities - /TIME - copy UniTrunker talkgroup and radio timestamps - /COMMS - copy UniTrunker talkgroup comms counts - /FULL - copy all applicable fields (same as /COLOR /PRIORITY /TIME /COMMS) - /ALL - copy all records (including those without useful names) - normally, records with blank name fields are not copied. The /ALL option forces copying of all talkgroup and radio records. You may want to use this option when copying your own UniTrunker files to TRUNK88. - first required command line argument is the path to UniTrunker files plus SysID, e.g. "c:\UT\1234" - the UniTrunker SYS, GID, and RID files are used as input - second required command line argument is the full path and filename for the TRUNK88 system control file, e.g. "c:\trunk88\1234.ctl" - this TRUNK88 system file must exist (it will not be created for you - use TRUNK88 to create it if it doesn't exist yet) - paths may be omitted for files that are in the current directory - examples: minimal copy: UT2T88 c:\UT\1234 c:\trunk88\1234.ctl maximal copy: UT2T88 /FULL /ALL c:\UT\3C08 c:\trunk88\TFS-TPS.ctl - None of the input files are modified; output is written to the file UT2T88.out - you can review the results with a text editor/viewer before replacing the original TRUNK88 file with the contents of UT2T88.out ---------------------------------------------------------------------------- - Note: UT2T88 does not normally process UniTrunker entries with blank names, since they generally contain no useful information. You can override this behaviour with the /ALL command line option. - processing is done in two phases: a) talkgroups, and b) radios - each phase consists of two sections: 1) processing ID's that are found in both the UniTrunker and TRUNK88 files (e.g. common to both files) 2) processing ID's that are only found in the UniTrunker file ---------------------------------------------------------------------------- - Options during section 1 processing: ( Note1 - if the TRUNK88 name for an ID appears to be derived from the UniTrunker name for that ID, the program assumes that no user input is required, and the program just moves on to the next ID (e.g. the entry in the TRUNK88 control file is left as is). The TRUNK88 name is assumed to be derived from the UniTrunker name if: a) the TRUNK88 name exactly matches the UniTrunker name (e.g. UniTrunker name = "water dept" and TRUNK88 name = "water dept", etc) or b) the TRUNK88 name exactly matches or ends with {UniTrunker name} (e.g. UniTrunker name = "water dept" and TRUNK88 name = "{water dept}" or UniTrunker name = "W45" and TRUNK88 name = "water dept {W45}", etc) ) ( Note2 - as each remaining ID (those that don't pass the tests in Note1) is processed, the names associated with that ID from the UniTrunker and TRUNK88 files are displayed along with a number of options. The examples below assume that the name found in the UniTrunker file is "abc", and the name found in the TRUNK88 file is "xyz" ) F1 - Use UniTrunker name - copies the name found in the UniTrunker file to the TRUNK88 file. The existing name (if any) in the TRUNK88 file is discarded - this is the option you would normally use for all ID's when copying your own UniTrunker files to TRUNK88 files F2 - Use {UniTrunker name} - copies the name found in the UniTrunker file to the TRUNK88 file, but with braces added ( "{abc}" ). The existing name (if any) in the TRUNK88 file is discarded - this option is useful when importing ID's from someone elses UniTrunker files and you want to distinguish them from your own ID's F3 - Use TRUNK88 name - the entry in the TRUNK88 file is left as is - useful when the UniTrunker name has no useable information, e.g. for stuff like "unknown??", etc. F4 - Use TRUNK88 name plus UniTrunker name - the names from both files are concatenated and placed in the TRUNK88 file ( "xyz abc" ) - useful when you want to keep the information from both files F5 - Use TRUNK88 name plus {UniTrunker name} - similar to F4, but with braces around UniTrunker name ( "xyz {abc}" ) - useful when you want to keep the information from both files. The braces show which part came from the UniTrunker file Ctrl F1/F2/F3/F4/F5 - batch processing - has the same effect as holding down the selected function key, e.g. all remaining ID's in the current phase/section are processed using the selected option ---------------------------------------------------------------------------- - The editing choices that follow are used to edit the onscreen data before selecting one of the above function keys. The usual field editing keys are available (Ins, Del, Backspace, Cursor Left/Right, Home, End, Ctrl End). Pressing Esc while editing cancels the operation (e.g. undo). 1 - Edit UniTrunker name - fairly self explanatory 2 - Edit UniTrunker name plus TRUNK88 name - TRUNK88 name is concatenated to UniTrunker name field (e.g. "abc xyz") prior to user editing of UniTrunker name field 3 - Edit TRUNK88 name - fairly straightforward 4 - Edit TRUNK88 name plus UniTrunker name - UniTrunker name is concatenated to TRUNK88 name field (e.g. "xyz abc") prior to user editing of TRUNK88 name field 5 - Edit TRUNK88 name plus {UniTrunker name} - similar to number 4, but with braces added ( "xyz {abc}" ) R - Reset names - cancels any editing that you've done to either name field - useful if you muck things up; has no effect if you haven't edited either name field S - Skip ID'd TRUNK88 entries - use this if you only want to copy UniTrunker names where the TRUNK88 name field is empty. The program will skip all ID's that have something entered in the TRUNK88 name field. Use this if you already have some ID'd talkgroups or radios in your TRUNK88 file, and you want to merge in someone else's UniTrunker data, but only for those ID's that you haven't already identified. ---------------------------------------------------------------------------- - Options during section 2 processing: ( after processing all ID's that are common to both files, the user is presented with the remaining ID's from the UniTrunker file that don't exist in the TRUNK88 file (e.g. ID's that UniTrunker has monitored, but TRUNK88 hasn't) Since there is no TRUNK88 record for these ID's, there is no TRUNK88 name for the user to accept, edit, concatenate, etc. Note that if the /ALL command line option was not specified, UniTrunker entries with blank name fields will not be presented/copied. ) F1 - Use UniTrunker name - creates an entry in the output file for this ID and uses the name from the UniTrunker file as is - this is the option you would normally use for all ID's when copying your own UniTrunker files to TRUNK88 files F2 - Use {UniTrunker name} - creates an entry in the output file for this ID and uses the name from the UniTrunker file, but with braces added ( "{abc}" ) - this option is useful when importing ID's from someone elses UniTrunker files and you want to distinguish them from your own ID's F3 - Don't add this ID - skips current ID - useful when the UniTrunker name has no useful information, e.g. for stuff like "unknown??", etc. Ctrl F1/F2/F3 - batch processing - has the same effect as holding down the selected function key, e.g. all remaining ID's in the current phase/section are processed using the selected option 1 - Edit UniTrunker name - same as before; allows you to edit the UniTrunker name field before selecting F1 or F2 R - Reset names - cancels any editing that you've done to the UniTrunker name field ----------------------------------------------------------------------------