EMS Manual
Collector Commands and Responses
EMS Manual—426909-005
19-50
REPLACE Command (ZEMS-CMD-REPLACE)
REPLACE Command (ZEMS-CMD-REPLACE)
The ZEMS-CMD-REPLACE command replaces a configured object in the EMS
collector with another object. The only supported object is an EMS filter (ZCOM-OBJ-
FILTER). The filter can be a compiled filter, a filter table, or a burst filter. Only one filter
at a time can be replaced in this command.
If required parameter tokens are specified in the new filter, these parameter tokens
must be included in the command. If optional parameter tokens are specified in the
filter, the parameter tokens are optional.
Although not extended SPI compliant, ZEMS-CMD-REPLACE is similar to the ZCOM-
ADD-FILTER command.
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.
Filter signifies that the required filter parameter tokens are required only if they are
defined as required parameter tokens in the filter.
Command Tokens
ZSPI-TKN-MAXRESP
ZCOM-TKN-XMGR
ZCOM-TKN-REQID-xxxx
ZCOM-TKN-OBJNAME
ZEMS-TKN-NEW-OBJNAME
<filter parameter token(s)>
ZSPI-TKN-CONTEXT
Token Type
ZSPI-TYP-INT
ZSPI-TYP-STRING
ZSPI-TYP-STRING
ZSPI-TYP-STRING
ZSPI-TYP-
BYTESTRING
Usage
Basic SPI
Optional
Optional
Required
Required
Filter
Basic SPI
Response Tokens
ZSPI-TKN-DATALIST
ZCOM-TKN-XMGR
ZCOM-TKN-RETCODE
ZCOM-TKN-OBJTYPE
ZCOM-TKN-OBJNAME
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
ZCOM-TKN-OBJTYPE
ZCOM-TKN-OBJNAME
ZSPI-TKN-ENDLIST
ZSPI-TKN-ENDLIST
ZSPI-TKN-CONTEXT
Token Type
ZSPI-TYP-LIST
ZSPI-TYP-STRING
ZSPI-TYP-INIT
ZSPI-TYP-ENUM
ZSPI-TYP-STRING
ZSPI-TYP-LIST
ZSPI-TYP-ERROR
ZSPI-TYP-ENUM
ZSPI-TYP-STRING
ZSPI-TYP-SSCTL
ZSPI-TYP-SSCTL
ZSPI-TYP-
BYTESTRING
Usage
Basic SPI
Unconditional
Unconditional
Unconditional
Unconditional
Error only
Error only
Error only
Error only
Error only
Basic SPI
Basic SPI