EMS Manual

EMS Procedures
EMS Manual—426909-005
15-3
Procedure Summary Tables
Table 15-2. EMS Procedures for Reporting Events
Name Token-Parameter Type Description
EMSINIT
EMSINITMAP
Value
Reference
Initializes an event-message
buffer: first step in event message
creation
EMSADDTOKENS
EMSADDTOKENMAPS
Value
Reference
Adds one to four tokens to a
buffer that has already been
initialized by EMSINIT or
EMSINITMAP
EMSADDSUBJECT
EMSADDSUBJECTMAP
Value
Reference
Adds an additional subject to an
event-message buffer
Table 15-3. Other EMS Procedures for Event-Message Processing
Name Token-Parameter Type Description
OPEN (Does not apply) Opens $0.#ZSPI, altcol.#ZSPI, or a
distributor for command messages. Opens
$0 or an alternate collector for event
messages.
*
CLOSE (Does not apply) Ends communication begun by the OPEN
procedure.
WRITEREAD (Does not apply) Transports command messages to and from
the distributor and collectors for the STATUS,
GETEVENT, GETVERSION, and CONTROL
commands. Reports standard event
messages to $0 and any alternate
collectors.
**
WRITE (Does not apply) Transport TEXT messages to collectors. The
text after 104 bytes is truncated.
SSPUT
SSPUTTKN
Reference
Value
Are used only for special operations such as
positioning.
SSMOVE
SSMOVETKN
Reference Move tokens from one message buffer to
another.
DEVICEINFO2 (Does not apply) Determines whether a named process is an
EMS collector.
* In COBOL85 programs, when sending EMS event messages and SPI commands to the primary collector (see
WRITEREAD), first use COBOL85^SPECIAL^OPEN instead of EMS OPEN to open the primary collector’s
$0.#ZSPI device. When sending EMS event messages and SPI commands to an alternate collector, first use
COBOL OPEN instead of EMS OPEN to open the alternate collector’s #ZSPI device.
** In COBOL85 programs, use COBOL WRITE to send event messages to the primary or alternate collector. Use
both COBOL WRITE with COBOL85^SPECIAL^OPEN to send SPI command messages to a primary or alternate
collector. In COBOL85 programs, do not use READ WITH PROMPT to send event messages to a primary or
alternate collector.