EMS Manual
EMS Programs
EMS Manual—426909-005
13-9
EMSCCTRL—Control Collector Utility
EMSCCTRL—Control Collector Utility
The EMSCCTRL utility lets you interactively manage the operation of the primary and
alternate collectors and the operation of the compatibility distributor.
EMSCCTRL supports a single input line from the TACL RUN command line. By
supplying one or more parameters, you select the operational characteristics of the
collector. EMSCCTRL translates the human-readable RUN parameters into a
CONTROL command (or DELETE FILTER or ADD FILTER command), sends the
command to the specified collector, and displays the response from that collector.
For information about the CONTROL, DELETE FILTER, and ADD FILTER command
messages that performs similar operations, see Collector Command Descriptions on
page 19-29.
You must have super-group privileges to use EMSCCTRL to manage the primary
collector. To manage an alternate collector, you must have super-group privileges or be
the user who started the alternate collector.
For a complete description of collector attributes, see Primary Collector Log Files on
page 12-3 and Alternate Collector Log Files on page 12-4.
The format of the EMSCCTRL RUN command is:
If you omit one of the options that follows the collector name on a particular
EMSCCTRL run, the corresponding attribute remains unchanged.
run-options
are any of the run options described in the TACL Reference Manual. Separate the
option names by commas.
HELP
displays a brief syntax description of EMSCCTRL. Omitting the collector name
and all collector options is equivalent to HELP.
col-name
is the name of the primary collector ($0) or alternate collector on the local
system. Use $0, not $Z0, to control either the primary collector or the
compatibility distributor associated with the primary collector.
acol-name
is the name of an alternate collector on the local system. If acol-name STOP
is specified, a shutdown of the named alternate collector is initiated.
EMSCCTRL [ / run-options / ] [ HELP ]
[ col-name col-options ]
[ acol-name STOP ]