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-STOP
Object Type
nl
ZPWY-OBJ-SC
Tokens in Command Buffer
nl
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
ZPWY-MAP-SEL-SC token-type ZPWY-DDL-SEL-SC.
!r
Tokens in Response Buffer
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
ZPWY-MAP-SEL-SC token-type ZPWY-DDL-SEL-SC.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Response Buffer
For STOP SC, common error values for ZSPI-TKN-RETCODE are:
DescriptionError TokenError Number
The server class is already stopped.ZPWY-ERR-PM-ALREADYSTOPPED1004
The server class must be frozen before you issue
a STOP SC command.
ZPWY-ERR-PM-MUSTBEFROZEN1062
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
Considerations
• The STOP SC command only initiates the transition of all server processes to the STOPPED
state. The command completes with a REQUEST PENDING status when all link managers have
not yet returned their links to a stopped or abended server, or when a server that no longer
has links to a link manager running.
• A server process can be programmed to stop itself (by calling the Guardian STOP procedure)
after receiving a CLOSE message from a link manager. The PATHMON process calls the
Guardian STOP procedure for servers that are running, are not associative, and have never
been linked.
• If an OSS server process starts another process not under PATHMON control, the second
process is not stopped when the PATHMON process stops the server class. For example, if
an OSS server process executes another process, the executed process is outside the PATHMON
environment. When the PATHMON process stops the OSS server class, the executed process
might become an orphan process.
THAW SC
Use the THAW SC command to allow link managers to resume sending requests to server processes
in a frozen server class.
THAW SC 161