EMS Manual
Collector Commands and Responses
EMS Manual—426909-005
19-44
GETVERSION Command (ZCOM-CMD-
GETVERSION)
Token Usage Considerations
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.
Optional signifies that the token is optional and need not be supplied by the user.
Required signifies that the token is required and must be supplied by the user.
Unconditional signifies that the token always appears in the response.
The presence of the ZCOM-TKN-GETVSN-SUPP-PARAMS command token
identifies this as the supplemental form of the ZEMS-CMD-GETVERSION
command. If the value of this command token is true, the supplemental token
ZCOM-TKN-GETVSN-LVL is returned in the response.
The ZCOM-TKN-GETVSN-LVL response token is returned only if the ZCOM-TKN-
GETVSN-SUPP-PARAMS token is in the command, and its value is true. The
value returned is ZCOM-VAL-GETVSN-ENLIT, which signifies that the collector is
capable of processing enlightened (post-D00) tokens and data structures.
The data list (all tokens from -DATALIST to -ENDLIST) forms a single response
record.
Error only signifies that this token is present only when an error or warning is
reported in the response record (ZSPI-TKN-RETCODE contains a nonzero value).
AC only signifies that the item is required for the alternate collector and is invalid
for the primary collector.
For a detailed description of these command and response tokens, see Common
Definitions of ZCOM- Commands on page 19-4.