EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-10
Distributor Errors
ZSPI-TKN-SERVER-BANNER (type char50)
contains the standard banner information.
ZSPI-TKN-SERVER-VERSION (type uint)
is the subsystem version number of the EMS distributor.
ZSPI-TKN-SSID (type ssid)
consists of ZSPI-VAL-TANDEM.ZSPI-SSN-ZEMS.ZSPI-VAL-VERSION, the
subsystem ID for the Event Management Service.
Distributor Errors
Response messages to distributor commands, like responses to all command
messages, contain the token ZSPI-TKN-RETCODE. A command was successful if the
ZSPI-TKN-RETCODE value is zero, or was unsuccessful (received an unrecoverable
error) if the token value is nonzero. The response message contains an error list if an
error or a situation requiring a warning has occurred.
Error Lists
A response message contains an error list if the distributor needs to specify errors or
warnings. The seriousness of the error list is indicated by the ZSPI-TKN-RETCODE
value: zero indicates warnings only; nonzero values indicate unrecoverable errors.
A response message with a ZSPI-TKN-RETCODE value of zero is accompanied by an
error list in either of these cases:

The command has succeeded after several unsuccessful tries.

The distributor has encountered a minor problem.
Several error lists—one following the other—can occur in one response message. For
example, an error list that represents a serious error can be followed by another error
list explaining that the distributor recovered from the first error. Several warnings—
each with its own error list—can also occur in one response message without the
occurrence of an error.