TS/MP 2.5 Management Programming Manual

perform the command. An error is a serious condition that prevents the command from being
completed. If the command completes with no errors, the value of the return token is zero. If
ZSPI-TKN-RETCODE has any nonzero value, it means an error has occurred. In this case, the
PATHMON process includes an error list in the response, providing information about the error.
A warning reports a condition less serious than that of an error. If no errors occur but a warning
occurs, the return token has a value of zero, but an error list appears in the response, providing
information about the warning condition.
An error list, which always begins with the token ZSPI-TKN-ERRLIST and ends with the token
ZSPI-TKN-ENDLIST, is returned only if an error is detected. The information in the list becomes
accessible when your program calls SSGET to select ZSPI-TKN-ERRLIST. Although the Pathway
subsystem only returns one error list per response, there can be nested error messages.
The PATHMON process does not provide support for continuing—despite errors— through the use
of the SPI standard token ZSPI-TKN-ALLOW-TYPE. The SPI standard token ZSPI-TKN-RETCODE
contains a nonzero value if the PATHMON process detects an error in a command message or
detects an error when attempting to perform a command. The Pathway subsystem can also return
file-system errors.
For more information on errors, error lists, and nested error messages, see “Event Management”
(page 163). For more information about ZSPI-TKN-ERRLIST and ZSPI-TKN-ENDLIST, see the SPI
Programming Manual.
Security
The owner of the user ID that starts the PATHMON process can set the ZOWNER and ZSECURITY
fields in ZPWY-DDL-DEF-PATHWAY during the execution of a START PATHWAY command to restrict
the use of a specific group of commands. Commands included in this restricted group are those
that can directly alter the state of an object. Table 9 (page 45) lists the restricted commands and
their object types:
Table 9 Restricted Commands and Objects for TS/MP
Use These Restricted (Sensitive) Commands (ZPWY-CMD- ) and Object Types
(ZPWY-OBJ- )…To Control…
PMCONTROLPATHMON and Pathway operations
PATHWAYSTOP
PATHWAYSHUTDOWN2
PMSWITCH
PATHWAYSTART
SCADDSERVER objects
SCASSIGN
SCPARAM
SCPROCESS
ZSCSTARTUP
SCALTER
SCASSIGN
SCPARAM
SCPROCESS
ZSCSTARTUP
SCDELETE
Security 45