TS/MP 2.5 Management Programming Manual

Considerations
• Deleting an SC object deletes the associated SCSTARTUP objects—you need not issue the
DELETE SCSTARTUP command.
• This command is equivalent to the PATHCOM ALTER SERVER, RESET STARTUP command.
FREEZE SC
Use the FREEZE SC command to prohibit all link managers, such as ACS subsystem processes
and Pathway/iTS TCPs, from sending requests to a server class.
If a server has incomplete requests (requests for which links have not yet been granted) or
outstanding requests (such as an active dialog), the PATHMON process cannot freeze the server
class until these requests are completed. While waiting for the requests to complete, the server is
in the FREEZE-PENDING state, and no new requests can be initiated.
If no incomplete or outstanding requests exist for any server in the server class, the PATHMON
process immediately freezes the server class.
Continuation
To freeze 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, responses are only returned for server classes in the THAWED state. 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-FREEZE
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
ZPWY-MAP-PAR-FREEZE-SC token-type ZPWY-DDL-PAR-FREEZE-SC.
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 FREEZE SC, a common error value for ZSPI-TKN-RETCODE is:
DescriptionError TokenError Number
The server class is already frozen.ZPWY-ERR-PM-ALREADYFROZEN1057
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
FREEZE SC 149