TS/MP 2.5 Management Programming Manual

Command Syntax
For tokens that may be present in the command and response buffers but are not listed, see “Unlisted
Tokens” (page 49). For descriptions of tokens and fields, see “SPI and EMS Standard Definitions”
(page 50) through “ZPWY-MAP- Definitions” (page 75).
Command
nl
ZPWY-CMD-ADD
Object Type
nl
ZPWY-OBJ-SCSTARTUP
Tokens in Command Buffer
nl
ZPWY-MAP-SEL-SCSTARTUP token-type ZPWY-DDL-SEL-SCSTARTUP.
!r
ZPWY-MAP-DEF-SCSTARTUP token-type ZPWY-DDL-DEF-SCSTARTUP.
!r
Tokens in Response Buffer
ZPWY-MAP-SEL-SCSTARTUP token-type ZPWY-DDL-SEL-SCSTARTUP.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Response Buffer
For ADD SCSTARTUP, common error values for ZSPI-TKN-RETCODE are:
DescriptionError TokenError Number
A startup message already exists for this server
class.
ZPWY-ERR-PM-DUPNAME1012
The value specified for ZMAXSTARTUPS was
reached.
ZPWY-ERR-PM-TOOMANYSCSTARTUP1104
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
Considerations
• The startup message provides a newly started server process with:
The names of the current default volume and subvolume◦
◦ The names of the IN file and the OUT file
◦ An optional text string contained in the ZAREA field of ZPWY-DDL-DEF-SCSTARTUP. The
SCSTARTUP object type is used to specify that string.
When the PATHMON process starts a COBOL server, the server’s run-time routines
automatically assimilate the startup message, PARAM message, and all of the ASSIGN
messages. Servers written in other languages must read and handle the startup, PARAM, and
ASSIGN messages as part of the application.
For more information on these messages, see the COBOL Manual for TNS and TNS/R Programs
and the Guardian Programmer’s Guide.
• Before adding a description to the startup message to the PATHMON configuration file, you
must assign values to all the required fields of this command.
• The associated server class must exist before you add the SCSTARTUP object.
138 Server Class Commands