TS/MP 2.5 System Management Manual

NOTE: You cannot embed PATHCOM comments in TACL scripts. In TACL scripts, information
enclosed in brackets is interpreted as a function, not as a comment. For information on including
comments in TACL scripts, see the TACL Reference Manual.
• A PATHCOM command-line spans input records if the last nonblank character is an ampersand
(&). Multiple commands, separated by semicolons, can appear on the same line. If command
parameters are repeated, PATHCOM uses the last value entered for a parameter.
Interactive Mode
PATHCOM functions in interactive mode when you enter commands from a terminal keyboard.
PATHCOM prompts for a command by printing an equal sign (=). When you enter a command,
PATHCOM runs the command and issues another prompt.
In this example, the first command starts the PATHMON process, the second command starts the
PATHCOM process, the third line shows the PATHCOM sign on, and the fourth line shows the
PATHCOM prompt:
TACL 8> PATHMON/NAME $PM1,CPU 0,NOWAIT/
TACL 9> PATHCOM $PM1
PATHCOM - T9153C31 - (08SEP92)
=
You can group two or more commands separated by semicolons (;). For example, these two
commands can be entered in two ways, as follows:
= command-1; command-2
or:
= command-1
= command-2
Pressing the terminal Break key during the execution of a PATHCOM command (described in
“PATHCOM Operation Commands” (page 137)) cancels the command; control remains with
PATHCOM and you can reenter the command. Pressing the Break key in all other instances,
including after the PATHCOM prompt appears, returns the terminal to the TACL command interpreter
without terminating PATHCOM. Enter “pause” at the TACL prompt to return the PATHCOM prompt
(=).
Running PATHCOM interactively allows you to monitor the status of the objects, dynamically start
and stop PATHMON-controlled objects, and inform the Pathway terminal operators about changing
conditions using tell messages.
Noninteractive Mode
PATHCOM functions in noninteractive mode when it reads commands from a command file.
In this example, PATHCOM reads commands from a file named CMDFILE and lists them on the
device $S.#LP. When it encounters an end-of-file command or an EXIT command, PATHCOM
terminates.
3> PATHCOM/IN CMDFILE,OUT $S.#LP, CPU 1, NOWAIT/$PM2
You can use DEFINEs to specify names for the files that PATHCOM uses directly as IN, OUT, and
OBEY command files. In this example, PATHCOM reads commands from the command file specified
by DEFINE =CMD-FILE ($DATA.PW.CONFIG) and lists them on the device specified by DEFINE
=OUT-FILE ($S):
12> ADD DEFINE =CMD-FILE, CLASS MAP, FILE $DATA.PW.CONFIG
13> ADD DEFINE =OUT-FILE, CLASS SPOOL, LOC $S, REPORT
"CONFIG"
14> PATHCOM /IN =CMD-FILE, OUT =OUT-FILE/ $PM
For detailed information about DEFINEs, see the TACL Reference Manual and the Guardian User’s
Guide.
130 Overview of PATHCOM