EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-31
ALTER Command (ZCOM-CMD-ALTER)

The data list (all tokens from -DATALIST to -ENDLIST) forms a single response
record. There can be multiple data lists (response records) in a response.

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).
For a detailed description of these command and response tokens, see Common
Definitions of ZCOM- Commands on page 19-4.
ALTER Command (ZCOM-CMD-ALTER)
The ZCOM-CMD-ALTER command alters objects in the EMS collector. The supported
objects are collectors (ZCOM-OBJ-COLL) and EMS filters (ZCOM-OBJ-FILTER).
Exactly one object name token is required with this command.
When the object is the EMS collector, this command functions like its basic SPI
counterpart (ZEMS-CMD-CONTROL). The only additional tokens required are the
collector control maps.
When the object is an EMS filter, the additional tokens are filter parameter tokens when
filter parameters are specified in the filter. Each ZCOM-CMD-ALTER command resets
the filter parameters for the specified filters, so all required filter parameters must have
tokens present in the command. The presence of tokens for the optional filter
parameters is optional.
Command Tokens
(-OBJ-COLL)
ZSPI-TKN-MAXRESP
ZCOM-TKN-XMGR
ZCOM-TKN-REQID-xxxx
ZCOM-TKN-OBJNAME
ZEMS-MAP-COL-CONTROL
ZEMS-MAP-ACOL-CONTROL
ZEMS-TKN-CDISTPRICPU
ZEMS-MAP-COL-CONTROL-
CDIST
ZEMS-MAP-BDS-CONFIG
ZSPI-TKN-CONTEXT
Token Type
ZSPI-TYP-INT
ZSPI-TYP-STRING
ZSPI-TYP-STRING
ZEMS-DDL-ACOL-
CONTROL
ZEMS-DDL-ACOL-
CONTROL
ZSPI-TYP-UINT
ZEMS-DDL-COL-
CONTROL-CDIST
ZEMS-DDL-BDS-
CONFIG
ZSPI-TYP-
BYTESTRING
Usage
Basic SPI
Optional
Optional
Required
Required
AC only
PC only
PC only
Required
Basic SPI