EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-8
Common Response Tokens for ZCOM- Commands
Response Token Usage Considerations

SSINIT signifies that the value for this token must be supplied in the call to SSINIT
to create the SPI command.

Basic SPI signifies that the presence of this token in the command is dictated by
the basic SPI command language standards that govern multiple objects and
responses. The EMS distributor’s extended programmatic interface deviates from
the SPI common extensions standard.

Error only signifies that this token is present only when an error or warning is
reported in the response record.

The data list (all tokens from -DATALIST to -ENDLIST) forms a single response
record. The distributor does not support multiple data lists. If multiple object
instances do occur, they are all returned in the same data list. The data list
enclosure is present only if MAXRESP is not equal to zero.
Common Response Token Descriptions
ZSPI-TKN-COMMAND
contains the command number for the request to which this is the reply. This value
is specified in the call to SSINIT.
ZSPI-TKN-OBJECT-TYPE
contains the type of object from the request to which this is the reply. This value is
specified in the call to SSINIT.
ZSPI-TKN-SSID
identifies the subsystem that processes the command. In the following response
tokens, it is always defined as ZPI-VAL-TANDEM.ZSPI-SSN-ZEMS.ZEMS-VAL-
VERSION. This value is specified in the call to SSINIT.
ZSPI-TKN-SERVER-VERSION
contains the release version of the server (the EMS distributor) that performed the
command. For this release version, it is D30.
ZEMS-TKN-DATALIST
indicates the beginning of a data list. Multiple object instances can be contained in
the list. The ZSPI-TKN-ENDLIST token indicates the end of the data list. These
tokens are used only when a non-zero value was specified in the command
MAXRESP token.
ZSPI-TKN-RETCODE
contains the return code, which indicates the outcome of the command processing.
If it is zero (ZCOM-ERR-OK), the command completed successfully without error. If