EMS Manual

Procedure Calls for Standard Events

EMS Manual—426909-005

11-2

Introduction to Procedure Calls

To generate a standard event, your subsystem must call the corresponding

event-building procedure followed by a send procedure. One event-building procedure

is provided for each of the standard event types.

To generate common tokens only, use the EMS_COMMON_TOKENS_EVT_BLD_

procedure call.

After calling an event-building procedure, you can append other tokens to the standard

event by calling the EMS procedures EMSADDTOKENS, EMSADDTOKENMAPS,

EMSADDSUBJECT, or EMSADDSUBJECTMAP.

The event-building procedures call EMSINIT internally, so users should not call

EMSINIT or EMSINITMAP when using the event-building procedures to generate the

standard events.

These procedures are callable from TAL, COBOL85, and C programs. The procedure

definitions are in the system file EXTDECS. The literals used in the procedure

descriptions are included in the files ZEMSDDL, ZEMSTACL, ZEMSC, ZEMSTAL, and

ZEMSCOB.

This section describes the event-building procedures. For the definition of required

tokens and their meanings, see Section 9, Standard Events.

EMS_TRANSIENT_FAULT_EVT_BLD_

Procedure

The EMS_TRANSIENT_FAULT_EVT_BLD_ procedure formats the standard transient

fault event. The event reports the object that received the transient fault.

Note. No range checking is done on the procedure parameter values except for current

state and previous state. Also, the value for BOOLEAN is ZSPI-VAL-FALSE (0) for

FALSE and is otherwise TRUE.