Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Event Management
Safeguard Management Programming Manual—422086-028
8-4
Event Numbers
defined by HP, do not begin any names defined in your application with uppercase or
lowercase Z.
Event Numbers
In the Safeguard subsystem, event numbers are represented by symbolic names of the
form ZSFG-EVT-name, where name identifies the event. Each event message is
assigned a different number. The Safeguard subsystem uses some shared code that is
named the common kernel. The common kernel might generate events, which are
represented by the symbolic names of the form ZCMK-EVT-name.
Subjects of Event Messages
The event-message subject token immediately follows the ZEMS-TKN-SUBJECT-
MARK token. In Safeguard event messages, the subject tokens are ZSFG-TKN-
PROC-ID (the process name).
To retrieve the subject token, you must first call EMSGET with the token code ZEMS-
TKN-SUBJECT-MARK to get the token code and the index of the subject token. Then
call EMSGET again with this token code and index to get the value of the subject
token.
Simple Tokens
Simple tokens—tokens whose values are single fields or fixed structures—are
identified by token codes. Codes for simple tokens used by the Safeguard subsystem
are represented by symbolic names of the form ZSFG-TKN-name, where ZSFG is the
four-character subsystem abbreviation and name identifies the specific token code. For
example, the token code ZSFG-TKN-CURRENTAUDITFILE contains the name of the
audit file currently in use.
Token Types
The token type is a part of the token code that consists of the token data type (for
example, signed integer) and the token length (for example, two bytes). Safeguard
token types are represented by symbolic names of the form ZSPI-TYP-name, where
ZSPI is the four-character abbreviation that identifies the token as a standard SPI
token type and name identifies the specific token type. There are no unique token
types specific to Safeguard.
Predefined Value Names
The predefined values used by the Safeguard subsystem are represented by symbolic
names of the form ZSFG-VAL-name, where ZSFG is the subsystem abbreviation and
name identifies a specific predefined value. For example, ZSFG-VAL-VERSION is a
predefined value that contains the current revision level of each Safeguard software
component.