DSM/SCM Event Management Programming Manual

Introduction
DSM/SCM Event Management Programming Manual529844-003
1-4
How Event Management Works
How Event Management Works
Event management is provided by EMS—a collection of processes, tools, and
interfaces for the reporting and retrieval of event messages.
An event message is a special type of SPI buffer. As a SPI buffer, the event message
is in the form of tokens that can be decoded programmatically by management
applications. Two types of EMS processes manage the flow of event messages:
Collectors accept event messages from subsystems and write them to log files.
Distributors retrieve selected event messages from the log files and send them to
processes, printers, terminals, and other destinations in the operations
environment.
Depending on the nature of the destination, one of four types of distributors can be
used:
The printing distributor filters specific events from the event log and sends them to
another disk file, terminal, or printer.
The consumer distributor filters specific events from the event log and returns them
to its requesting management application. A management application can request
all or specific subsystem event messages from the EMS consumer distributor.
Event-message selection is based on a filter loaded into the consumer distributor.
After it retrieves and decodes an event message, the management application can
take an appropriate action, if necessary, in response to the event. For the use of
filters to select DSM/SCM event messages, see Section 3, SPI Programming
Considerations for DSM/SCM.
The compatibility distributor ($Z0) writes event messages to the console. $Z0
generates the timestamp and process ID and sends the event message to the
console in the DSM display format.
The forwarding distributor filters specific events from the event log and sends them
to another node on the network.
For a detailed description of EMS, see the EMS Manual.
In addition to this EMS processing, DSM/SCM itself retrieves and decodes its event
messages for display in the Planner Interface and Target Interface. The Planner
Interface displays all messages generated on the host. Once a snapshot is received
from the target, it also displays the messages generated on the target. The Target
Interface displays all messages generated on the target. For more information on
viewing EMS messages in these interfaces, see the DSM/SCM User’s Guide.