TS/MP 2.5 Management Programming Manual

Event Messages
Each Pathway subsystem event message is contained within an event-message buffer consisting
of:
• Message header token—contains the value ZSPI-VAL-EVTHDR, which identifies a message as
an event message. The event-message header is built by the EMSINIT procedure. The header
differs from the standard command header by omitting some command and response tokens
and including some standard EMS tokens. Header tokens can be extracted from the
event-message header by calling the EMSGET procedure with specific token codes.
• Standard EMS tokens—Appear in all event messages.
• Standard SPI tokens—Appear in all event messages.
• Standard Pathway tokens—Appear in all Pathway subsystem event messages.
• Event-specific Pathway tokens—Appear in some Pathway subsystem event messages.
• Nested messages—Might appear in some Pathway subsystem event messages.
Tokens in Pathway subsystem event messages are classified as one of:
• Unconditional tokens: Present in the event message
• Conditional tokens: Might be present in the event message
• HP internal tokens: Reserved for HP use only
Header Tokens
Table 26 (page 167) lists the standard EMS tokens that appear in an event-message header; they
are unconditional tokens.
Table 26 Standard EMS Header Tokens
DescriptionData TypeToken and Token Type
Identifies the processor in which
PATHMON process was running when
the event message was generated.
16-bit integerZEMS-TKN-CPU
nl
ZSPI-TYP-INT
Contains the Guardian internal format
process ID of PATHMON process.
8 bytesZEMS-TKN-CRTPID
nl
ZSPI-TYP-CRTPID
Contains the estimate by PATHMON
process of the seriousness of the event.
16-bit integerZEMS-TKN-EMPHASIS
nl
ZSPI-TYP-BOOLEAN
If the value is ZSPI-VAL-TRUE, the event
is a Pathway subsystem internal error
condition. If the value is
ZSPI-VAL-FALSE, the event is a status or
warning event or an error event that is
not an internal error.
Identifies the Pathway subsystem event
number. This token can assume any of
16-bit integerZEMS-TKN-EVENTNUMBER
nl
ZSPI-TYP-INT
the Pathway subsystem event values of
the form
ZPWY-EVT-objecttype-eventname
(for example,
ZPWY-EVT-PM-DUPNAME). The
numbers represented by the event
values are the same as the numbers of
the corresponding PATHMON process
or link manager errors.
Contains the time PATHMON process
recorded the event in the internal log
queue.
64-bit integerZEMS-TKN-GENTIME
nl
ZSPI-TYP-TIMESTAMP
Event Messages 167