EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-40
CONTROL Command (ZEMS-CMD-CONTROL)
ZCOL-CDIST-MODE-SET (enum field)
indicates that $Z0 displays only critical events if ON, or all events if OFF.
ZCOL-CDIST-USER-SET (userid field)
specifies the user ID that the compatibility distributor must use when
forwarding event messages to the console from a remote collector (one on
another node). You can perform the same operation using the EMSCCTRL
command (or the PUP CONSOLE command on systems running the D-series).
Tokens in Response Buffer
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. For a
list of the values that can be returned in the ZSPI-TKN-RETCODE token, see
Error-Handling Notes
on page 19-40.
ZSPI-TKN-SERVER-VERSION (type uint)
is the subsystem version number of the EMS collector.
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.
Error-Handling Notes
Table 19-7 shows the names and numbers of ZSPI-TKN-RETCODE values specific to
the CONTROL command.
Table 19-7. Values of ZSPI-TKN-RETCODE Specific to CONTROL
Command (page1of2)
Name
(ZEMS-ERR-) Number Description
INV-CPU 1009 CPU number in ZCOL-PRIMARYCPU was not the backup
CPU for $0 or for the alternate collector.
CPU-RANGE 1010 CPU number in ZCOL-PRIMARYCPU is invalid; it must be 0
to 15.
CDIST-CPU 1013 CPU number in ZEMS-TKN-CDISTPRICPU was not the
primary or backup CPU for $Z0.