Requirement: Have a team mate review any changes made to aps_file, to receive their approval.
1. Login to the Dispatcher application server (using "PuTTY" or similar).
2. * ALWAYS make a copy of the aps_file prior to making any changes.
Take a safe copy of existing aps_file, for example:
cd $HOME/dcs
cp -p aps_file aps_file.safecopy-18-06-2014
3. Open the aps_file in VI (or another text editor of your choice):
vi $HOME/dcs/aps_file
4. Take a note of last entries in the existing file, use them to base new ones on, keeping sequence of port number and
workstation id. For each RDT there are two entries to be added, one "ritch", one "ptysvr", for example:
rdt process rdt192 $rdt_on_off revive:
ritch ritch -d $DCS_TMPDIR -i 192 -w rdt192 -s -r 8 -c 20
;
pty process pty192 $pty_on_off revive:
ptysvr ptysvr -n -t -p 8247 crtrdt -i 192 -n -a -r 8 -c 20
;
rdt process rdt193 $rdt_on_off revive:
ritch ritch -d $DCS_TMPDIR -i 193 -w rdt193 -s -r 8 -c 20
;
pty process pty193 $pty_on_off revive:
ptysvr ptysvr -n -t -p 8248 crtrdt -i 193 -n -a -r 8 -c 20
;
So to add the next two in sequence:
rdt process rdt194 $rdt_on_off revive:
ritch ritch -d $DCS_TMPDIR -i 194 -w rdt194 -s -r 8 -c 20
;
pty process pty194 $pty_on_off revive:
ptysvr ptysvr -n -t -p 8249 crtrdt -i 194 -n -a -r 8 -c 20
;
rdt process rdt195 $rdt_on_off revive:
ritch ritch -d $DCS_TMPDIR -i 195 -w rdt195 -s -r 8 -c 20
;
pty process pty195 $pty_on_off revive:
ptysvr ptysvr -n -t -p 8250 crtrdt -i 195 -n -a -r 8 -c 20
;
5. Workstation id's are in Hexadecimal when the "-i" flag is used so the ongoing sequence from here would be:
196,197,198,199,19A,19B,19C,19D,19E,19F,1A0,1A1,1A2 and so on.
6. Port numbers follow logically, so 8251, 8252, 8253 etc, as long as they are not already in use for other devices.
7. Once new entries are added, corresponding workstation entries in Dispatcher created, and physical terminals configured with
relevant port number, save change to aps_file (in VI "Esc" then ":wq" then "enter" to save changes and exit VI).
8. Issue "telsia refresh" command from the dcsdba command line to effect the changes.
