TS/MP 2.5 Management Programming Manual

STOP PATHWAY causes the PATHMON process to delete all servers that are not linked to a link
manager. ACS subsystem processes are notified of the STOP PATHWAY command and prohibited
from sending requests to Pathway subsystem server classes.
If you are using Pathway/iTS, then note that this command is the same as the PATHCOM SHUTDOWN
command, except that the TERM objects and TCP objects are not automatically stopped; you must
stop all the TERM objects and TCP objects before issuing this command.
Continuation
You cannot use continuation with this command.
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-PATHWAY
Tokens in Response Buffer
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Response Buffer
For STOP PATHWAY, common error values for ZSPI-TKN RETCODE are:
1004 (ZPWY-ERR-PM-ALREADYSTOPPED)
indicates the Pathway subsystem is already stopped.
1045 (ZPWY-ERR-PM-STATEMISMATCH)
indicates the Pathway subsystem is not in the appropriate state to allow the
PATHMON process to execute the STOP request.
For descriptions of all error token values and their associated error lists, see “Event Management”
(page 163).
Considerations
• To implement the equivalent of the PATHCOM SHUTDOWN command, issue these commands
in this order:
1. Issue a STOP TERM command for each Pathway/iTS TERM, specifying continuation.
2. Issue a STOP TCP command for each Pathway/iTS TCP, specifying continuation.
3. Issue a STOP PATHWAY command.
For more information about continuation, see “Specifying Continuation” (page 40). For more
information about Pathway/iTS commands, see the Pathway/iTS Management Programming
Manual.
• To implement the equivalent of the PATHCOM SHUTDOWN ! command, add an ABORT TERM
command for all TERMs (specifying continuation) after the STOP TERM command in the
previous sequence.
• To implement the equivalent of the WAIT option for the PATHCOM SHUTDOWN command,
reissue the STOP command sequence repeatedly until ZSPI-TKNRETCODE returns no error.
STOP PATHWAY 127