SNAX/XF and SNAX/APN Event Management Programming Manual

SNAX/XF and SNAX/APN Event Management Programming Manual—426859-001
1-1
1
Introduction
SNAX/XF and SNAX/APN provide information about events occurring within their
respective subsystems by sending Event Management Service (EMS) event messages.
These two subsystems share a common subsystem ID and send messages with a ZSX1-
prefix. Applications can obtain these event messages by:
•
Starting an EMS consumer distributor process
•
Issuing distributor programmatic command and selecting the collector or log file
from which the events are to be retrieved
•
Issuing a GETEVENT command to the EMS consumer distributor
•
Using the ESMGET procedure to extract the event message from the response buffer
•
Using EMSGET to extract the individual tokens from the event message
For complete information about how to process an event message, see the EMS Manual.
An application can also specify that a filter be applied to select certain events. Filters are
programs that allow applications to select particular event messages from the totality of
event messages issued. Filters select event messages to be returned to an application by
examining the values of tokens in an event message. Any token can be used for selecting
event messages; you can create filters that return all event message issued in a particular
time period, all event messages with a certain event number, and so forth. The EMS
Manual explains how to write filters.
Figure 1-1
shows the basic elements of the Event Management Service and traces the
flow of event messages from their point of origin to their final destination. Event
messages are first sent to the primary event collector ($0). A consumer distributor can
retrieve all event message or a filtered subset of messages and send them to an SPI
management application. Consumer distributors can also send event messages to
NetMaster or to a user-written console application. A printing distributor can be used to
send messages to a printer, database file, or terminal.