GDSX Management Programming Manual

GDSX Management Programming Manual—529930-001
6-1
6 Event Messages
The GDS subsystem provides information about events that occur in the subsystem by
issuing event messages. A management application can obtain these event messages
by opening an Event Management System (EMS) distributor process and requesting
the messages. The application can also specify that a filter be applied to select certain
event messages.
This section describes the event messages that the GDS subsystem can issue and the
specific programming considerations for dealing with GDS event messages in an
application. For general information on how an application obtains event messages
from data communications subsystems, refer to the SPI Common Extensions Manual.
In this section, event-message tokens and their values are represented in DDL. For a
brief explanation of DDL as it applies to SPI, refer to Appendix B in the SPI
Programming Manual.
Subsystem Processes That Report Events
Both the SCP and the GDS subsystems can issue event messages related to the GDS
subsystem. The event messages issued by SCP contain the SCP subsystem ID, while
those issued by the GDS subsystem contain the GDS subsystem ID.
The GDS subsystem ID is described in Section 4, Common Definitions. The subsystem
ID for SCP is described in the SPI Common Extensions Manual. For more information
about subsystem IDs, refer to the SPI Programming Manual.
The event messages issued by SCP are described in the SPI Common Extensions
Manual.
Within the GDS subsystem, both TSCODE and USCODE can issue event messages.
Refer to the EMS Manual for information about how to issue event messages.
Table 6-1 lists the event messages that the GDS subsystem can issue.
Table 6-1. GDS Subsystem Event Messages (page 1 of 2)
Event
Number Symbolic Name (ZGDS-EVT-) Description
1001 STARTUP Execution begins
1002 SHUTDOWN Orderly shutdown
1003 DEV-HANDLER-ERR Device handler procedure not bound in
GDS object code
1004 LINE-HANDLER-ERR Line handler procedure not bound in GDS
object code
1005 USER-TERMINATED User terminated GDS object code
1006 SHUTDOWN-PENDING GDS shutdown pending
1021 TASK-FAULT Task fault