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

Pathway Subsystem Control Commands
NonStop TS/MP Management Programming Manual—540082-001
8-11
START PATHWAY
Tokens in Response Buffer
For START PATHWAY, common error values for ZSPI-TKN-RETCODE are:
1003 (ZPWY-ERR-PM-ALREADYSTARTED)
indicates that the PATHMON process has already been started.
1008 (ZPWY-WRN-PM-BADPATHCTL)
indicates that the PATHMON configuration file is empty or does not contain a valid
state.
1031 (ZPWY-ERR-PM-MISSINGPARAM)
indicates that a required Pathway configuration parameter was not defined.
For descriptions of all error-token values and their associated error lists, see
Section 10, Event Management..
Considerations
•
You can issue a START PATHWAY command for a different (remote) Pathway
subsystem (one controlled by a PATHMON process different from the PATHMON
process controlling your local Pathway subsystem).
•
To perform a cold start even if a PATHCTL file already exists, specify ZPWY-MAP-
PAR-START-PATHWAY2 with the ZIGNORE field set to ZPWY-VAL-YES and the
ZSTART field set to ZPWY-VAL-COLD. This combination causes PATHMON
process to overwrite the existing configuration file.
•
To perform a cool start that ignores the state of the configuration file or that ignores
a PATHMON process name that does not match the name of the PATHMON
process you are running, omit ZPWY-MAP-DEF-PATHWAY and use ZPWY-MAP-
PAR-START-PATHWAY2 with the ZIGNORE field set to ZPWY-VAL-YES and the
ZSTART field set to ZPWY-VAL-COOL. The PATHMON process then uses the
existing configuration file and does not use the error conditions.
If the PATHMON configuration file is missing or is not readable, the start always
fails.
•
HP recommends setting ZNODEINDEPENDENT to ON. When
ZNODEINDEPENDENT is set to ON and you omit the node name for any file-
name attribute, or if you specify \* for the node name, the node name used is the
node the PATHMON process is running on after cool start.