TS/MP 2.5 Management Programming Manual

• When ZMODE is set to ORDERLY or ABORT mode, the PATHMON process sends a single
shutdown request to each locally controlled Pathway/iTS TCP. The TCP acknowledges the
request and begins the shutdown phase, denying all requests to start new work. This mode
of operation allows all locally controlled TCPs to shut down in parallel, reducing the time
required to shut down the Pathway subsystem.
• When ZMODE is set to IMMEDIATE mode, the PATHMON process immediately stops all
servers and Pathway/iTS TCPs, halting any work currently in progress. This mode further
reduces the time required to shut down the Pathway subsystem. However, because the TCPs
are immediately stopped, they are unable to reset terminals. For more information on resetting
terminals, see the Pathway/iTS Management Programming Manual.
• During shutdown, the PATHMON process automatically stops logging all status messages
except messages 1005 (shutdown completed) and message 1151 (PATHMON stopped),
which are logged as usual.
• The error ZPWY-ERR-PM-SHUTDOWNTIMEOUT (error 1154) indicates that the subsystem has
not shut down, but the SHUTDOWN2 PATHWAY command has timed out.
START PATHWAY
Use the START PATHWAY command to start a Pathway subsystem, either by creating a new
PATHMON configuration file (cold start), replacing an existing configuration file (cold start with
ZIGNORE), or using the configuration in the existing configuration file (cool start).
For detailed information on the form and function of the PATHMON configuration file (PATHCTL
file) and for guidelines on calculating appropriate configuration values for your site, see the TS/MP
2.5 System Management Manual.
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-START
Object Type
nl
ZPWY-OBJ-PATHWAY
Tokens in Command Buffer
nl
ZPWY-MAP-PAR-START-PATHWAY2 token-type ZPWY-DDL-PAR-START-PATHWAY2.
ZPWY-MAP-DEF-PATHWAY token-type ZPWY-DDL-DEF-PATHWAY.
!r
Tokens in Response Buffer
ZSPI-TKN-RETCODE token-type ZSPI-TYP-INT.
Tokens in Command Buffer
ZPWY-MAP-DEF-PATHWAY
this token is required for cold starts. When this token is not included, the existing
PATHMON configuration file is used (cool start).
Tokens in Response Buffer
For START PATHWAY, common error values for ZSPI-TKN-RETCODE are:
START PATHWAY 123