Pathway/iTS Management Programming Manual

PROG Commands
NonStop Pathway/iTS Management Programming Manual—426749-002
9-18
START PROG
Tokens in Response Buffer
ZSPI-TKN-RETCODE
For START PROG, common error values for ZSPI-TKN-RETCODE are:
For descriptions of error-token values and their associated error lists, see
Section 11, TCP Event Messages and Section 12, TCP Error Messages.
Considerations
•
Control of the device specified in the ZFILE field in ZPWY-DDL-PAR-START-
PROG passes to the TCP while the TCP executes the SCREEN COBOL program.
•
In addition to specifying the options for the ZNOWAIT field, you can also specify a
file name in the ZFILE field. The file name is the name of the TERM object used as
the I/O device for the specified program.
Specifying a TERM name as the file allows you to run your management
application on one terminal and the SCREEN COBOL program on another
terminal. However, unless you assign the value ZPWY-VAL-ON to the ZNOWAIT
field, you cannot use the terminal running your management application because
this terminal will have to wait for the SCREEN COBOL program to finish running on
the other terminal.
Consequently, when you want the PATHMON process to reply to your
management application before the SCREEN COBOL program completes:
•
Specify ZPWY-VAL-ON for ZNOWAIT.
•
Assign a name, different from the file name of the TERM object on which your
Pathsend requester application program is running, to the ZFILE field in
Tokens in Response Buffer
ZPWY-MAP-SEL-PROG token-type ZPWY-DDL-SEL-PROG. !r
ZPWY-MAP-STARTPROG token-type ZPWY-DDL-STARTPROG.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Error
Number Error Token Description
1052 ZPWY-ERR-PM-TCPNOTDEFINED The TCP named in the PROG
object’s definition is not
configured.
1086 ZPWY-ERR-PM-CLASSNOTDEFINED No value has been assigned to the
ZTERMTYPE field in ZPWY-MAP-
PAR-START-PROG.