EMS Manual

EMS Manual—426909-005
21-1
21 Distributor Errors
This section lists error codes and warning codes returned by the distributor:
Following the code of each error or warning is a box with the name and type of tokens
that constitute the related error list. Following the box a description of the error’s
cause, effect, and recovery actions that can be taken.
All distributor response messages contain ZSPI-TKN-RETCODE and can include one
or more error lists even when the command is successful (ZSPI-TKN-ERROR value is
zero) if something unusual occurred. Each error list contains a ZSPI-TKN-ERROR
token and often contains other tokens as well, depending on the situation.
For more information about distributor error lists, see Section 17, Distributor
Commands and Responses.
Token and Data Type Definitions
Distributor error lists include some tokens and values defined by SPI (prefixed by
ZSPI) as well as those defined by EMS (prefixed by ZEMS). These tokens and values
are defined here, rather than with each error list, because most of them occur in
several error lists.
SPI Token Codes
These SPI tokens (tokens with prefix ZSPI) occur in distributor error lists:
ZSPI-TKN-COMMAND (type enum)
specifies the distributor command.
ZSPI-TKN-CONTEXT (type bytestring)
is the token saved by the distributor to record its position in the log file.
ZSPI-TKN-ENDLIST (type
ssctl)
is the SPI token that ends a list—an error list in this section. The DDL for ZSPI-
TKN-ENDLIST is:
DEF IS ZSPI-DDL-INT4.
Topic Page
Token and Data Type Definitions
21-1
Distributor Warning Codes 21-4
Distributor Error Codes 21-6
Note. To express SPI token types such as ZSPI-TYP-UINT, the following listings omit ZSPI-
TYP- and place the remainder in italicized, lowercase letters, as in (type uint).