Safeguard Reference Manual (G06.24+, H06.03+ )

Event-Exit-Process Commands
Safeguard Reference Manual—520618-013
15-14
Interprocess Communication Messages
Table 15-2 shows the structure of the header data sent from the Safeguard subsystem
to the event-exit process. The header is always present. When the event-exit process
responds to an event request, it is expected to alter these fields in the header data:
•
Message_Tag
•
Error
•
Status
•
Subject_Data
•
Message_Data
Table 15-2. Header_Data (page 1 of 3)
Base INT[0:-1] The base from which the offsets to other
data areas are calculated. Base indicates
the allocation of a placeholder, not data. It is
used for reference for all offsets and
VAR-STRING fields within the messages.
Event_Type INT An enumeration describing the type of
Message_Data in the message. Valid
message types are Access_Control, Logon,
Password Quality, and Logon^Abort.
MSG_Version INT The version of this message structure. This
value can be either 1 or 2. If 1, the status
field is 23. If 2, the status field is as
described in Table 15-7. The version is
established by Safeguard. The event-exit
process is responsible for checking the
message version and rejecting any message
it does not recognize. The rejection is
returned in the Error field of this header.
Min_MSG_Version INT The oldest version of the message that must
be supported by the event-exit process in
order to interpret this message. Currently,
this value is 1.
Subject_Data INT The byte offset to the subject data
associated with this message. It must be an
even number.
Set to 0 in response from the event exit.
Message_Data INT The byte offset to the message data
associated with this message. It must be an
even number.
Set to 0 in response from the event exit if
there is no response message data. Set to
the data offset by the event exit if there is
message response data.