EMS Manual

EMS Programs
EMS Manual—426909-005
13-34
EMSDIST—Distributor Program
EMSDIST—Distributor Program
The EMSDIST program is the object program for a printing, forwarding, or consumer
distributor, any of which you can start with a TACL RUN command.
To access log-file messages, the person or process that runs EMSDIST must have
read access to the log files that EMSDIST accesses. Super-group privileges are
required if the collector creates its log files with the protection string COOO, which is
the system default. For more information, see the SECURITY collector-option in
EMSCCTRL—Control Collector Utility on page 13-9, or the ZCOL-PROTECTION field
in CONTROL Command (ZEMS-CMD-CONTROL) on page 17-17.
If you use a NEWPROCESS procedure call to start EMSDIST, use the minimum
number of distributor options on the NEWPROCESS call, because startup error
messages are not designed for programmatic access. For example, you can start a
consumer distributor and supply only NAME or NAME process-name on the
NEWPROCESS call. You can then use command messages to provide the additional
information that the distributor requires.
If you enter EMSDIST with no parameters, the EMSDIST program displays a help
screen with the EMSDIST syntax.
Critical events are marked with an asterisk (*) character that is placed two columns
before the subsystem ID in the output of a printing distributor.
run-options
are any of the run options valid for the RUN command in TACL, separated by
commas, as described in the TACL Reference Manual. These options are of
particular importance for this command:
NAME [ process-name ]
gives the name of the distributor process. You must supply the NAME
[process-name] information.
NOWAIT
returns a TACL prompt to you while the distributor continues to run.
CPU cpu
gives the number of the processor where the primary process of the distributor
is to execute.
OUT filename
specifies the file name to send event messages to. You must use this option, or
distributor error messages are not sent anywhere. If no file name is specified,
EMSDIST [ / run-options / ] dist-options