Pathway/XM System Management Manual

PXMCOM Commands
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
11-51
RUN PROGRAM
RUN PROGRAM
This command initiates the execution of a SCREEN COBOL program on a device
interoperating with your Pathway/XM 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 PXMCFG ADD TERM
statement.) Assigns an object name beginning with a number to distinguish it from
configured TERM objects.
2. If necessary, starts the TCP process 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 process 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.
If you want PXMCOM 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
PXMCOM encounters the command in a command file.
program-name
specifies the name of a previously defined PROGRAM object.
run-parameter
specifies one or more parameters to be run.
RUN PROGRAM program-name
[ , run-parameter [ , run-parameter ]... ]
run-parameter is:
PRINTER { file-name [ IS-ATTACHED ] }
{ IS-ATTACHED }
FILE file-name
TYPE program-type
NOWAIT