EMS Manual

Distributor Commands and Responses
EMS Manual—426909-005
17-18
CONTROL Command (ZEMS-CMD-CONTROL)
ZEMS-TKN-REPLACE-PARAM (type Boolean)
if equal to ZSPI-VAL-TRUE, directs the distributor to replace the current parameter
tokens with the parameter tokens supplied by this command message.
parameter-tokens are one or more user-defined tokens: the parameter tokens
for the event-message filter. See Passing Filter Parameters on page 17-21.
A CONTROL command message that contains parameter tokens must also
contain a ZEMS-TKN-FILTERFILE or ZEMS-TKN-REPLACE-PARAM token.
ZEMS-TKN-RESET-FILTER (type Boolean)
if equal to ZSPI-VAL-TRUE, directs a consumer or printing distributor to replace the
current filter with the default filter. The default filter for consumer or printing
distributors passes all event messages. This command is not defined for
forwarding distributors; if attempted, the error ZEMS-ERR-NULL-FILTER is
returned.
ZEMS-TKN-GMTTIME (type timestamp)
positions the distributor at a new place in the event-message source. The
distributor examines event messages that have a generation time the same as (or
later than) ZEMS-TKN-GMTTIME. A value of -1 requests that event messages be
returned as the collector logs them. For more information, see Positioning Within
Event-Message Sources on page 17-22. GMTTIME is the time of the event’s
origin.
ZEMS-TKN-LOGTIME (type timestamp)
positions the distributor at a new place in the event-message source. The
distributor examines only those messages written to the log at or after the logging
time given by ZEMS-TKN-LOGTIME. For more information, see Positioning Within
Event-Message Sources on page 17-22. Logtime is the time when the event is
written to the log; events within the log file are sorted by their logtime.
ZEMS-TKN-REPLACE-TGT-COLL (type fname)
directs a forwarding distributor to disconnect the current target collector and to
connect the new target collector. Subsequently, the distributor forwards event
messages to the new collector.
ZEMS-TKN-CONNECT-SRC-COLL (type fname)
names a collector whose log files will serve as a source of event messages for this
distributor. This token includes a log file event message source. For more
information, see Specifying Event-Message Sources
on page 17-22.