TS/MP Management Programming Manual (G06.24+, H06.03+)

Server Class Commands
NonStop TS/MP Management Programming Manual—540082-001
9-45
THAW SC
Tokens in Response Buffer
For STOP SC, common error values for ZSPI-TKN-RETCODE are:
For descriptions of all error-token values and their associated error lists, see
Section 10, Event Management.
Considerations
•
The STOP SC command only initiates the transition of all server processes to the
STOPPED state. The command completes with a REQUEST PENDING 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 has not stopped.
•
A server process should 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.
Continuation
To thaw all server classes, initialize the ZSERVERCLASS field in ZPWY-DDL-SEL-SC
to ZPWY-VAL-ALLSC. Reissue the command continually by using the context token
returned by the PATHMON process until no data is returned in the reply buffer.
When you specify continuation, responses are only returned for server classes that are
frozen. For more information, see Specifying Continuation on page 3-17.
Error
Number Error Token Description
1004 ZPWY-ERR-PM-
ALREADYSTOPPED
The server class is already stopped.
1062 ZPWY-ERR-PM-
MUSTBEFROZEN
The server class must be frozen before you
issue a STOP SC command.