TS/MP 2.5 Management Programming Manual

STOP PM
Use the STOP PM command to stop the PATHMON process pair; the Pathway subsystem must be
currently in the process of shutting down (ZPATHWAYSTATE is set to ZPWY-VAL-SHUTDOWN).
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-PM
Tokens in Response Buffer
ZSPI-TKN-RETCODE token-type ZPSI-TYP-INT.
Tokens in Response Buffer
For STOP PM, the common error value for ZSPI-TKN-RETCODE is:
1045 (ZPWY-ERR-PM-STATEMISMATCH)
indicates the Pathway subsystem is not in the SHUTDOWN state.
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
Considerations
All processes started by the PATHMON process and still running when the STOP PM command
completes successfully are orphaned. Orphaned processes are processes that are no longer
recognized by the PATHMON process.
To avoid orphaned processes, first use the STATUS PATHWAY command before executing the
STOP PM command to determine what type of processes are running. Use the STATUS command
on each type of object to find the names of the active processes and then stop each process. After
all processes are stopped, execute the STOP PM command.
SWITCH PM
Use the SWITCH PM command to direct the PATHMON process to exchange the function of its
primary process with the function of its backup process while the PATHMON process is running.
This command does not change the PATHMON CPU definitions in the PATHMON configuration
file.
Continuation
You cannot use continuation with this command.
128 Pathway Subsystem Control Commands