Distributed Name Service (DNS) Management Programming Manual

Retrieving and Decoding Event Messages
SPI Programming Considerations for DNS
3–12 46958 Tandem Computers Incorporated
h. If you encounter the error-list token (ZSPI-TKN-ERRLIST), make another call
to EMSGET or EMSGETTKN to retrieve the tokens inside the error list.
i. Take action appropriate to the information in the event message.
The Event Management Service (EMS) Manual provides information on how to retrieve
tokens from an event message.
Event-Management
Considerations for DNS
The overall goal of event reporting by DNS is to allow the system operator or a
management program to monitor and control the operation of the subsystem. The
DNS subsystem reports events to EMS but not to the Tandem Maintenance and
Diagnostic Subsystem (TMDS).
All event messages except the routine status messages have the value of the ZEMS-
TKN-CONSOLE-PRINT token set to ZSPI-VAL-TRUE. This causes t them to be routed
by the EMS compatibility distributor ($Z0) to the designated operator console and, in
compatible mode, to the OPRLOG and any $AOPR process.
DNS does not report any action events, normal occurrences that require operator
intervention, or additions, deletions, or changes of names in the DNS database.
Processes that retrieve DNS event message should declare a buffer of at least 512 bytes.
Some DNS event messages contain error lists. Some of these error lists provide
information for use by your application; others contain information you should report
to your Tandem representative. The descriptions in Section 6 of individual event
messages explain what to do with each error list.
Critical Events Critical events can have serious consequences, such as the loss of data or of a major
DNS function. The value of the event message token ZEMS-TKN-EMPHASIS
indicates whether an event is critical. If the value is ZSPI-VAL-TRUE, the event is
critical; if the value is ZSPI-VAL-FALSE, the event is not critical. Section 6 lists the
individual critical events returned by DNS, along with recommended action.