EMS Manual

EMS Manual426909-005
15-1
15 EMS Procedures
EMS procedures help you process event messages. You can:
Retrieve information from event messages
Produce display text derived from event messages
Create event messages
These procedures work hand-in-hand with SPI procedures and are similar to them in
many ways.
Event messages, like command messages, are based on SPI tokens. For a thorough
discussion of issues that apply to both command messages and event messages, such
as standard definition files, see the SPI Programming Manual.
Applications in TAL can call EMS procedures directly; COBOL85 applications can call
them through the COBOL85 ENTER TAL feature. You can use TACL to retrieve or
display event messages by invoking TACL built-ins #EMSGET, #EMSGETV,
#EMSTEXT, and #EMSTEXTV, but you cannot use TACL to report events.
This section describes the procedures used by management applications to retrieve
information from event messages and the procedures used by subsystems to produce
event messages:
If your program will retrieve event messages, read Section 4, Retrieving Event
Messages Programmatically; Section 17, Distributor Commands and Responses; and
Section 5, Compiled Filters
.
If your program will report event messages, read Section 8, Reporting Events;
Section 9, Standard Events; Section 10, Generating Standard Events; and Section 11,
Procedure Calls for Standard Events.
Topic Page
Which Procedures to Use
15-2
Required Declarations and Standard Definitions 15-7
Procedure Descriptions 15-8