Guardian Application Conversion Guide

Converting Distributed Systems Management (DSM) Applications
Converting Other Parts of an Application
8–24 096047 Tandem Computers Incorporated
Defining the Event-Message Buffer
Your DSM application might define a buffer to receive the event message. The
D-series event-message header contains the new variable-length process-descriptor
token, ZEMS-TKN-PROC-DESC, which makes the D-series header approximately 24
bytes larger than a C-series header. Also, because the process-descriptor token is a
variable-length string, a D-series event message has a variable length.
If necessary, modify the event-message buffer in your DSM application to hold a
larger variable-length event message.
Processing D-Series Tokens
Table 8-3 shows the D-series EMS tokens. You might need to convert your application
to process these new tokens. (The D-series EMS tokens that are specific to a subsystem
are described in the subsystem’s management programming manual.)
Table 8-3. D-Series Event Management Service (EMS) Tokens
Token Name
(ZEMS-TKN- )
Token Type
(ZSPI-TYP- ) Description
D00 BOOLEAN Header token that specifies whether the event message
is generated by a D-series system or C-series system.
Supported only by EMSGET[TKN].
EVTHDR-VSN ENUM Header token containing the event-header version. The
value for the initial release is 1.
LDEVNUMBER INT2 Token used for a logical device number (32 bits).
NODENAME STRING Token containing the node (system) name of the
subsystem that created the event.
NODENUM INT2 Header token containing the node (system) number of
the subsystem that created the event. Replaces
ZEMS-TKN-SYSTEM.
PROC-DESC STRING Header token containing the process descriptor of the
subsystem that created the event. Replaces ZEMS-
TKN-CRTPID.
XLDEVNAME STRING Token used for a logical device name.
XSENDERID STRUCT Token containing the system number (32 bits), CPU (16
bits), and PIN (16 bits) that created the event.
Supported only by EMSGET[TKN].
XSENDERID-PD STRING Token containing the process descriptor of the
subsystem that created the event. Supported only by
EMSGET[TKN].