TS/MP 2.5 Management Programming Manual

Considerations
• This command starts the number of server processes defined by the ZNUMSTATIC field in
ZPWY-DDL-DEF-SC.
• The ASSIGN messages are built directly from the information you provide in the ADD
SCASSIGN command. The PARAM message contains one item for each parameter value you
specify for the ZAREA field in ZPWY-DDL-DEF-SCPARAM (with the ADD SCPARAM command).
The number of the CPU not chosen for the primary process is reported in the BACKUPCPU
parameter, which the PATHMON process adds to the PARAM message. For a description of
how this value is chosen, see the ADD SC command.
• For information about associative servers, see “Server Objects” (page 47).
START SCPROCESS
Use the START SCPROCESS command to start a single named server process in a given server
class.
Continuation
To start all server processes for a server class, initialize the ZSERVERCLASS field in
ZPWY-DDL-SEL-SCPROCESS to the name of the server class, and initialize the ZPROCESS field to
ZPWY-VAL-ALLSCPROCESS. Reissue the command continually by using the context token returned
by the PATHMON process until no data is returned in the reply buffer. For more information, see
“Specifying Continuation” (page 40).
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-START
Object Type
nl
ZPWY-OBJ-SCPROCESS
Tokens in Command Buffer
nl
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
ZPWY-MAP-SEL-SCPROCESS token-type ZPWY-DDL-SEL-SCPROCESS.
!r.
Tokens in Response Buffer
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
ZPWY-MAP-SEL-SCPROCESS token-type ZPWY-DDL-SEL-SCPROCESS.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Response Buffer
For START SCPROCESS, common error values for ZSPI-TKN-RETCODE are:
DescriptionError TokenError Number
The specified file cannot be used for a home
terminal.
ZPWY-ERR-PM-ALREADYSTARTED1003
An error occurred while the PATHMON process
was attempting to create a new process.
ZPWY-ERR-PM-NEWPROCESS1038
START SCPROCESS 157