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

Event Management
NonStop TS/MP Management Programming Manual—540082-001
10-14
Example Error Lists
The information in the error list becomes accessible when your program calls the SPI
SSGET procedure. SSGET extracts a token from the buffer after the PATHMON
process has processed a command and returned a response message. SSGET does
not return tokens that are outside the error list until you select the ZSPI-TKN-ENDLIST
token.
Example Error Lists
These scenarios produce two different response messages from the PATHMON
process.
Scenario 1
Your management application issues a START SC command for CLASS-A, but
CLASS-A has already been started. The response message your program receives
contains:
ZSPI-TKN-PARM-ERR This token contains the code of the token in error and
the offset to the field in error. ZSPI-TKN-PARM-ERR is
used for field validation and identifying required fields
that are missing. Information about this token appears
in the DSM Programming Manual.
Tokens Sometimes Present (continued)
ZPWY-TKN-ERRCOMMAND This token identifies the command that caused the
error. If the command is unavailable, this token
contains the value ZSPI-VAL-NULL-COMMAND.
ZPWY-TKN-ERROBJECTTYPE This token identifies the object type that caused the
error; this token is often the same as ZPWY-TKN-
REQOBJECTTYPE.
ZPWY-TKN-nnnNAME This token identifies the name of the Pathway
subsystem object that is the subject of the error
message. nnn represents the Pathway subsystem
object type received in the request.
ZPWY-TKN-ERRINFO This token contains additional information about the
error. ZPWY-TKN-ERRINFO has the token number
ZPWY-TNM-ERRINFO and the token type ZSPI-TYP-
INT.
ZPWY-TKN-ERRINFO2 This token also contains additional information about
the error. ZPWY-TKN-ERRINFO2 has the token
number ZPWY-TNM-ERRINFO2 and the token type
ZSPI-TYP-ERRINFO2.
Table 10-7. Error List Tokens (page 2 of 2)
Token Description