EMS Manual

EMS Components and Architecture
EMS Manual—426909-005
2-15
EMS Utility Programs

FILTER, which identifies the compiled filters, filter tables, and up to one burst
filter that can be added to the collector to implement pre-log filtration

EMSDIST (EMS Distributor) is the object program for starting printing distributors,
forwarding distributors, or consumer distributors. Like EMSACOLL, the EMSDIST
program provides a number of command parameters, including the FILTER
parameter.
For more details on these object programs, see Section 13, EMS Programs.
For information about using the EMSDIST program to translate EMS events into
NonStop SNMP traps, see Translating an EMS Event Into an SNMP Trap on
page 13-51 and the SNMP Configuration and Management Manual.
EMS Utility Programs
HP provides three utility programs as part of EMS that provide an interactive means for
controlling and inquiring about collectors and distributors:

EMSCCTRL (EMS Collector Control) lets you change the values of options
controlling the primary collector ($0), alternate collectors, and the compatibility
distributor ($Z0). Among other things, these options control how a collector
maintains its log files.

EMSCINFO (EMS Collector Information) displays the current settings of the
primary and alternate collector options, information about the status of the
compatibility distributor, and statistics describing file operations and occurrences of
event messages.

EMSDINFO (EMS Distributor Information) displays the current settings of the
distributor options, the status of event message sources and destinations, and
statistics about filter operations and errors.
For more details on these utility programs, see Section 13, EMS Programs
.
EMS Procedures
Several EMS-related procedures are available as part of the procedures library:

Retrieve information from event messages

Create event messages
The two procedures that relate to retrieving information are EMSTEXT (see Text
Formatting Tools on page 2-12) and EMSGET. EMSGET retrieves tokens from event
messages, as SSGET retrieves tokens from command messages.
Several procedures build event messages:

EMSINIT initializes an event-message buffer, creating the correct header format for
event messages and inserting standard information it derives from parameters and
from other sources.