Pathway/iTS System Management Manual (G06.24+)

PROGRAM Commands
HP NonStop Pathway/iTS System Management Manual—426748-002
11-10
RUN PROGRAM Command
RUN PROGRAM Command
Use the RUN PROGRAM command to initiate the execution of a SCREEN COBOL
program on a device interoperating with your PATHMON environment. When this
command is issued, the PATHMON process performs the following:
1. Creates a temporary TERM object based on the configuration information in the
PROGRAM object template. (This is similar to the ADD TERM command.) Assigns
an object name beginning with a number to distinguish it from configured TERM
objects.
2. If necessary, starts the TCP that controls the device.
3. Starts the newly created temporary TERM object. (This is similar to the START
TERM command.)
4. Passes control of the device to the TCP while the TCP executes the SCREEN
COBOL program.
5. After the screen program terminates and if no other programs are using the same
temporary TERM object, or when the TERM object is aborted, deletes the
temporary TERM object. (This is similar to the DELETE TERM command.)
If you want PATHCOM to be available before the SCREEN COBOL program
completes, specify the NOWAIT parameter.
The RUN PROGRAM command must be issued interactively. This command fails if
PATHCOM encounters the command in a command file.
program-name
specifies the name of a previously defined PROGRAM object.
program-parameter
specifies one or more parameters to be run.
RUN [ PROGRAM ] program-name
[ , program-parameter [ , program-parameter ]... ]
program-parameter is:
PRINTER { file-name [ IS-ATTACHED ] }
{ IS-ATTACHED }
FILE file-name
TYPE program-type
NOWAIT