TS/MP 2.5 Management Programming Manual

!r
ZPWY-MAP-DEF-SCPROCESS token-type ZPWY-DDL-DEF-SCPROCESS.
!r
Tokens in Response Buffer
ZPWY-MAP-SEL-SCPROCESS token-type ZPWY-DDL-SEL-SCPROCESS.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Response Buffer
For ADD SCPROCESS, common error values for ZSPI-TKN-RETCODE are:
DescriptionError TokenError Number
A server process by this name already exists for
this server class.
ZPWY-ERR-PM-DUPNAME1012
The value specified for
ZMAXSERVERPROCESSES was reached.
ZPWY-ERR-PM-TOOMANYSCPROCESS1103
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
Considerations
• An associative server is configured with the ZASSOCIATIVE field in ZPWY-DDL-DEF-SCPROCESS
set to ZPWY-VAL-ON. When changing the definition of an associative server, make sure you
make the changes everywhere the associative server is defined. Otherwise, you cannot be
assured that the new definition is implemented or permanent.
For more information on associative servers, see “Server Objects” (page 47).
• Before adding a description for a server process to the configuration file, you must assign
values to all of the required fields listed in this command.
• The PATHMON process names the server processes when it creates them by assigning the
names in the order you define them.
• The number of server process definitions in this server class cannot exceed the value of
ZMAXSERVERS in ZPWY-DDL-DEF-SC. The combined value of ZMAXSERVERS in
ZPWY-MAP-DEF-SC for all server classes cannot exceed the value of ZMAXSERVERPROCESSES
in ZPWY-MAP-DEF-PATHWAY. Processes that are not explicitly described have the default
names supplied by the PATHMON process, and their definitions have default values for all
the process attributes.
• The associated server class must exist before you add the SCPROCESS object.
• To specify node independence for server class attributes, specify \* for node names or omit
node names and set ZNODEINDEPENDENT to ON in the START PATHWAY command.
ADD SCSTARTUP
Use the ADD SCSTARTUP command to specify a character string to be sent to a server process in
the startup message.
Continuation
You cannot use continuation with this command to add all startup strings; you must explicitly add
each startup string. There can be only one startup string per server class.
ADD SCSTARTUP 137