EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-29
REPLACE Command (ZEMS-CMD-REPLACE)
REPLACE Command (ZEMS-CMD-REPLACE)
The ZEMS-CMD-REPLACE command replaces a configured object in the EMS
distributor 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 using 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 the ZEMS-CMD-REPLACE does not comply with the distributor’s extended
command interface and does not support multiple filter objects, it 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.

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.

Unconditional signifies that the token always appears in the response.

Error only signifies that this token is present only when an error or warning is
reported in the response record.

If the REPLACE command was not successful, the original filter is replaced.
For a detailed description of these command and response tokens, see Common
Definitions for ZCOM- Commands on page 17-5.
Command Tokens
ZSPI-TKN-MAXRESP
ZCOM-TKN-OBJNAME
ZEMS-TKN-NEW-OBJNAME
<filter parameter
token(s)>
Token Type
ZSPI-TYP-INT
ZSPI-TYP-STRING
ZSPI-TYP-STRING
Usage
Basic SPI
Required
Required Filter
Response Tokens
ZSPI-TKN-DATALIST
ZSPI-TKN-RETCODE
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
ZSPI-TKN-ENDLIST
ZSPI-TKN-ENDLIST
Token Type
ZSPI-TYP-LIST
ZSPI-TYP-ENUM
ZSPI-TYP-LIST
ZSPI-TYP-ERROR
ZSPI-TYP-SSCTL
ZSPI-TYP-SSCTL
Usage
Basic SPI
Unconditional
Error only
Error only
Error only
Basic SPI