EMS Manual

EMS Manual—426909-005
13-1
13 EMS Programs
This section describes the programs you can run to change the configuration of or
display status information about various EMS components:
To start and stop these EMS programs, use the TACL RUN and STOP commands.
Several utility programs help you monitor and manage components of EMS.
Each utility interprets the requests that you provide through run options and command-
line options, performs the requested action, and terminates execution.
These utilities provide many of the capabilities available to you through collector and
distributor command messages. You can run EMSCINFO to determine the status of a
collector or the compatibility distributor, and EMSDINFO to determine the status of a
consumer, printing, or forwarding distributor. Also, you can use EMSCCTRL to control
the operation of the collectors and their log files, and the compatibility distributor. But
you must use command messages to control the operation of a consumer, printing, or
forwarding distributor; no utility program performs this function.
To understand collector attributes and how they are interrelated, see the corresponding
command messages in Section 17, Distributor Commands and Responses
, or
Section 19, Collector Commands and Responses
. Collector attributes are described in
terms of RUN-command options in this section and in terms of token fields in
Section 19, Collector Commands and Responses, but the underlying operations are
the same.
Topic Page
EMSACOLL—Alternate Collector Program
13-2
EMSCCTRL—Control Collector Utility 13-9
EMSCINFO—Collector Information Utility 13-18
EMSDINFO—Distributor Information Utility 13-29
EMSDIST—Distributor Program 13-34
Table 13-1. Programs That Start EMS Components
Program Description
EMSACOLL Object program for the alternate collector
EMSDIST Object program for a consumer, forwarding, or printing distributor process
Table 13-2. EMS Utility Programs
Program Description
EMSCCTRL Controls the operation of the primary and alternate collectors and the
attributes of collector log files; also controls the compatibility distributor
EMSCINFO Displays current collector operational information and event-message
statistics
EMSDINFO Displays current distributor information and filter statistics