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

Event Management
NonStop TS/MP Management Programming Manual—540082-001
10-13
Error Messages
Error Messages
Most Pathway subsystem errors reported to a management application are returned in
the response buffer the application receives from the PATHMON process. Pathway
subsystem errors reported to SPI requesters are returned in one of these:
•
As a number in the ZSPI-TKN-RETCODE token, which is always returned in the
response buffer
•
In an error list, which is a component of a response buffer that is returned only if an
error is detected
Error Lists
An error list contains a group of tokens that together form a complete description of a
single error. Table 10-7 lists the tokens that are always present in an error list and
those that are sometimes present in an error list.
Table 10-7. Error List Tokens (page 1 of 2)
Token Description
Tokens Always Present
ZSPI-TKN-ERRLIST This token marks the beginning of an error list. It
identifies an error list containing additional information
about an error reported in ZSPI-TKN-RETCODE.
ZSPI-TKN-ENDLIST This token marks the end of an error list.
ZSPI-TKN-ERROR This token contains the Pathway subsystem ID and an
error number. Error numbers are represented by
symbolic names of the form ZPWY-ERR-
objecttype-message, where objecttype is the
object type affected, and message names the error.
ZPWY-TKN-REQCOMMAND This token identifies the command from the request. If
the command is unavailable, this token contains the
value ZSPI-VAL-NULL-COMMAND.
ZPWY-TKN-REQOBJECTTYPE This token identifies the object type from the request. If
the object type is unavailable, this token contains the
value token ZSPI-VAL-NULL-OBJECT-TYPE.
Tokens Sometimes Present
ZPWY-TKN-REQ nnnNAME This token identifies all object names from the
corresponding object-selector token. If the name is
unavailable or the object does not require a selector
(for example, the PATHMON or PATHWAY object), this
token is absent.