EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-45
GETVERSION Command (ZEMS-CMD-
GETVERSION)
GETVERSION Command (ZEMS-CMD-GETVERSION)
The ZEMS-CMD-GETVERSION command returns the version number of the
programmatic interface to the primary or alternate collector.
Tokens in Response Buffer
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 collector.
ZSPI-TKN-RETCODE (type enum)
is the standard SPI return token. A zero value for this token signals the successful
execution of the command. A nonzero value signals that the command failed.
ZSPI-TKN-SSID (type ssid)
contains ZSPI-SSN-ZEMS, the subsystem ID for the Event Management Service.
ZSPI-TKN-COMMAND (type enum)
is the original command.
ZEMS-TKN-COLLECTOR (type enum)
contains the value ZEMS-SUBJ-ACOLL (2) when the alternate collector returns a
response. This token is not returned by the primary collector.
Error-Handling Notes
No error codes are defined that are unique to this command.
Command
ZEMS-CMD-GETVERSION
Tokens in Command Buffer
None
Tokens in Response Buffer
ZSPI-TKN-SERVER-BANNER token-type ZSPI-TYP-CHAR50.
ZSPI-TKN-SERVER-VERSION token-type ZSPI-TYP-UINT.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-SSID token-type ZSPI-TYP-SSID.
ZSPI-TKN-COMMAND token-type ZSPI-TYP-ENUM.
ZEMS-TKN-COLLECTOR token-type ZSPI-TYP-ENUM.