EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-14
ALTER Command (ZCOM-CMD-ALTER)
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.
When the object is a target collector for a forwarding distributor, the object name must
specify the name of the new target collector that is to replace the current target
collector.
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.

Required signifies that the token is required and must be supplied by the user.

Optional signifies that the token is optional and need not be supplied by the user.

Filter signifies that the required filter parameter tokens are required only if they are
defined as required parameter tokens in the filter.

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.
Command Tokens (OBJ-FILTER)
ZSPI-TKN-MAXRESP
ZCOM-TKN-OBJNAME
<filter parameter
token(s)>
Token Type
ZSPI-TYP-INT
ZSPI-TYP-
STRING
Usage
Basic SPI
Required
Filter
Command Tokens (OBJ-TARGET)
ZSPI-TKN-MAXRESP
ZCOM-TKN-OBJNAME
Token Type
ZSPI-TYP-INT
ZSPI-TYP-
STRING
Usage
Basic SPI
Required
Response Tokens
ZSPI-TKN-DATALIST
ZCOM-TKN-RETCODE
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
ZSPI-TKN-ENDLIST
ZSPI-TKN-ENDLIST
Token Type
ZSPI-TYP-LIST
ZSPI-TYP-INIT
ZSPI-TYP-LIST
ZSPI-TYP-ERROR
ZSPI-TYP-SSCTL
ZSPI-TYP-SSCTL
Usage
Basic SPI
Unconditional
Error only
Error only
Error only
Basic SPI