EMS Manual

EMS Manual—426909-005

4-1

Retrieving Event Messages

Programmatically

This section describes the interface between a management application and a

consumer distributor.

Because event messages follow the SPI format, and the interface to the distributor

follows the command-message protocol, you should be familiar with the SPI

Programming Manual.

Section 3, Retrieving Event Messages Interactively

, also applies to this section. This

section starts from the point where the system is correctly configured, EMS is running,

and compiled filter specifications are available to you.

This section provides a perspective about the programmatic interface to the consumer

distributor:

Detailed explanations are provided in later sections. You might want to read this

section again after reading them.

For sample code (in several programming languages) that retrieves event messages,

see Appendix A, Example of Retrieving Event Messages.

To retrieve event messages:

1. Start a distributor process interactively (using a TACL RUN command) or

programmatically (using the NEWPROCESS procedure).

2. Open the distributor’s command-response interface.

3. Establish the desired environment: the filter and, optionally, its parameters; the

event-message source (or sources); and the log-file position.

4. Request each event message from the distributor, and extract the desired

information from each event message.

5. Close the distributor.

Topic Page

Getting Started

4-2

Changing the Environment 4-4

Retrieving Event Information 4-12