EMS Manual

Configuring EMS
EMS Manual—426909-005
12-13
Consumer, Forwarding, and Printing Distributors
Starting a Distributor
You control whether a distributor runs as a process pair by specifying or omitting the
BACKUP option when you issue the TACL command to start the distributor.
When you start a distributor, you must specify the distributor type. You can also provide
several additional items of information. The distributor startup parameters are:

Distributor type. You must select a printing, forwarding, or consumer distributor by
including the TYPE keyword: TYPE PRINTING (or TYPE P), TYPE FORWARDING
(TYPE F), or TYPE CONSUMER (TYPE C).

For routing distributors (printing distributors with a filter containing destination
profiles): the filters can contain destination profiles to direct events to selected
destinations. If the startup line contains a TEXTOUT parameter, specification of
a filter with destination profiles results in an error. If multiple filters are used
with no destination profiles, the distributor does not process any subsequent
filters after encountering a filter with a PASS condition.
Consumer and forwarding distributors can be used with multiple filters, but not
with destination profiles.

For printing distributors only: the TEXTOUT option designates the destinations
(processes, devices, or disk files) to which the distributor sends the event-
message text. You can specify up to ten destinations.

For forwarding distributors only: the TARGET option designates the collector to
which the distributor is to forward its event messages. You can specify only
one collector. It can be a primary or alternate collector on a local or remote
system.

For consumer distributors only: the management application that opens the
distributor’s programmatic interface is its only destination.

Source of event messages. To designate the source of the event messages the
distributor is to process, specify:

COLLECTOR, if you want the distributor to access the current log-file set of the
collector or collectors you have named. You can specify up to ten collectors.

LOGFILE, if you want the distributor to access the log file you have named.
This feature is typically used for archived log files. You can specify only one log
file.

Neither COLLECTOR nor LOGFILE, if you intend to supply a collector name or
log-file name later, through the distributor’s programmatic interface.
Specifying both COLLECTOR and LOGFILE is not allowed.

Generation time of the first message. Specify a value for the TIME option to
indicate that you want the distributor to start processing the log files at the first
event message whose generation time is the same as or later than the time you