GDSX Management Programming Manual

Event Messages
GDSX Management Programming Manual—529930-001
6-6
Event Messages
Event Messages
Each event message that can be issued by the GDS subsystem is described here in
detail. The descriptions are given in ascending order by event number; that is, in
ascending order by the ZGDS-EVT- values.
Within each event-message description, there is a box that lists all the tokens that can
appear in the event message. Header tokens are listed here, because an application
can filter event messages on header tokens as well as on other tokens. All tokens are
unconditional tokens (that is, they are always present in the event message).
With the exception of the token ZEMS-TKN-SUBJECT-MARK and the token listed after
it, the order of the tokens in the box is not necessarily the order in which they will
actually appear in an event message. The token ZEMS-TKN-SUBJECT-MARK always
immediately precedes the subject token of an event message. For more information on
the subject token, refer to the EMS Manual.
The box also contains the text version of the event message, which is available
through the EMSTEXT procedure. When you use the EMSTEXT procedure to get the
text version of an event message, you request either the display format or the console-
compatible format, as described in the EMS Manual. In the case of GDS event
messages, there is no difference between the two formats, and the two versions are
identical to the corresponding console message.
The notation used in the box for simple tokens is a shorthand version of the essential
information given in the DDL TOKEN-CODE statement. Following the box, the event-
message tokens are described in the same order in which they appear in the box.
Table 6-5. Subsystem-Specific EMS Tokens
Token and Token Type Description
ZGDS-TKN-ID
ZSPI-TYP-STRING
Contains the
product number and date for the
GDS version. It is a 20-byte string.
ZGDS-TKN-PROCNAME
ZSPI-TYP-STRING
Contains the process ID of the process
generating the event. It is the subject of the
event message.
ZGDS-TKN-SEVERITY
ZSPI-TYP-ENUM
Indicates the severity of this event message as
follows:
•
ZGDS-VAL-SEV-STATUS indicates that this event
reports the status only.
•
ZGDS-VAL-SEV-WARN indicates that this event
reports a warning only. The process is still
operational.
•
ZGDS-VAL-SEV-ERR indicates that this event
reports an error that prevents the process from
operating.