EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-9
Common Response Tokens for ZCOM- Commands
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. Its value is of the form ZCOM-OBJ-objtype.
ZSPI-TKN-SSID
identifies the subsystem that processes the command. In the following response
tokens, the subsystem is always defined as ZSPI-VAL-TANDEM.ZSPI-SSN-
ZEMS.ZEMS-VAL-VERSION. This value is specified in the call to SSINIT.
ZSPI-TKN-SERVER-VERSION
contains the release identifier of the server (the EMS collector) that performed the
command. For this version, it is D31 or F40.
ZSPI-TKN-DATALIST
indicates the beginning of a data list. One response record is contained in each
data list. The ZSPI-TKN-ENDLIST token indicates the end of the data list. These
tokens are used only when a value other than zero was specified in the command
-MAXRESP token. If the -MAXRESP value is other than zero and there are
multiple responses, there might be multiple data lists (response records) in the
response.
ZCOM-TKN-XMGR
is returned for all commands and contains the name of the collector that processed
the SPI command.
ZSPI-TKN-RETCODE
contains the return code, which indicates the outcome of the command processing.
If the value is zero (ZCOM-ERR-OK), the command completed without error. If the
value is not zero, an error occurred, and the response record contains an error list
that describes the error.
ZCOM-TKN-OBJTYPE
specifies the object type for ZCOM-TKN-OBJNAME. This value is usually the same
as the value specified in the ZSPI-TKN-OBJECT-TYPE token in the command.
ZCOM-TKN-OBJNAME
specifies the name of the object acted upon by the command. If the command
acted upon multiple objects, multiple occurrences of this token are returned, each
within its own response record.
ZSPI-TKN-ERRLIST
indicates the beginning of an error list. ZSPI-TKN-ENDLIST indicates the end of
the error list, and the error list can be nested. An error list is put in the response for