EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-17
CONTROL Command (ZEMS-CMD-CONTROL)
CONTROL Command (ZEMS-CMD-CONTROL)
The ZEMS-CMD-CONTROL command directs a distributor to change its operational
environment: to change its source of event messages (and the position within the
source at which examination of event messages begins), to install or change a filter or
filter parameters, and to change the destinations of event messages that pass the filter.
Tokens in Command Buffer
ZEMS-TKN-FILTERFILE (type fname)
is the name of a file that contains the filter object program. To specify a filter,
include this token. In the case of a filter table or burst filter, you can give the EDIT
file name instead.
Note. Because the ZCOM-CMD-ADD, -ALTER, and -DELETE commands use the distributor’s
object-oriented extended interface, use these commands, whenever possible, instead of the
ZEMS-CMD-CONTROL command. For example, the CONTROL command can only load a
single filter, and in doing so deletes all existing filters in the distributor.
Command
ZEMS-CMD-CONTROL
Tokens in Command Buffer
ZEMS-TKN-FILTERFILE token-type ZSPI-TYP-FNAME
ZEMS-TKN-REPLACE-PARAM token-type ZSPI-TYP-BOOLEAN
ZEMS-TKN-RESET-FILTER token-type ZSPI-TYP-BOOLEAN
ZEMS-TKN-GMTTIME token-type ZSPI-TYP-TIMESTAMP
ZEMS-TKN-LOGTIME token-type ZSPI-TYP-TIMESTAMP
ZEMS-TKN-REPLACE-TGT-COLL
token-type ZSPI-TYP-FNAME
ZEMS-TKN-CONNECT-SRC-COLL
token-type ZSPI-TYP-FNAME
ZEMS-TKN-DISCONNECT-SRC-COLL
token-type ZSPI-TYP-FNAME
ZEMS-TKN-ADD-TEXTOUT token-type ZSPI-TYP-FNAME
ZEMS-TKN-DELETE-TEXTOUT token-type ZSPI-TYP-FNAME
ZEMS-TKN-CONNECT-LOG token-type ZSPI-TYP-FNAME
ZEMS-TKN-DISCONNECT-LOG token-type ZSPI-TYP-FNAME
ZEMS-TKN-EOFDELAY token-type ZSPI-TYP-INT
ZEMS-TKN-SEQ-BLOCKING token-type ZSPI-TYP-BOOLEAN
Tokens in Response Buffer
ZSPI-TKN-RETCODE token-type ZSPI-TYP-ENUM
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST
.
.
.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL