EMS Manual

EMS Programs
EMS Manual—426909-005
13-36
EMSDIST—Distributor Program
As the distributor examines event messages, the event messages from the log
files of every collector name in the COLLECTOR option are merged by event-
message generation time.
LOGFILE name
is the name of a log file to serve as the unique source of event messages for
this distributor. The LOGFILE option excludes use of the COLLECTOR option.
FILTER { file-name }
{ ( file-name [ , file-name ] ... ) }
is the name or list of names of the filters to be installed in the distributor.
Multiple filters are executed in sequential order for each event. A filter can be a
compiled filter, a filter table, or a burst filter. A maximum of ten filters, including
one burst filter, is allowed. An EDIT file is accepted for a filter table or a burst
filter. When a burst filter is specified, BDS is activated when the distributor
starts. If you omit the FILTER parameter when starting up a printing or
consumer distributor, a default filter is used. For more information about default
filters, see Section 17, Distributor Commands and Responses.
If you omit the FILTER option, distributor operation depends on the type of
distributor:

Consumer or printing distributors pass all event messages.

Forwarding distributors wait for a filter to be loaded.
For a description of the CONTROL command message that loads, changes,
and resets filters, see Distributor Command Descriptions on page 17-12.
TARGET collector-name
(for a forwarding distributor only) gives the name of the primary or alternate
collector to which event messages are forwarded.
TEXTOUT { name }
{ ( name [ , name ] ... ) }
(for a printing distributor only) gives the name (or a list of names) of devices,
processes, and disk files that receive display-formatted event messages. The
parentheses in the list alternative are required.
You can include a maximum of ten TEXTOUT names.
A printing distributor can be configured to determine its home terminal and use
it as a TEXTOUT device by specifying TEXTOUT $home. This allows
configuration of a dynamic telnet session that automatically starts up a printing
distributor that determines its own destination.
If the specified filename does not exist, the printing distributor creates an entry-
sequenced file with a record length of 80, a default extent of 20 pages, and a