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

Table Of Contents
Event-Exit-Process Commands
Safeguard Reference Manual 520618-030
15 - 13
Interprocess Communication Messages
Examples
To display the event-exit attributes for an event-exit process that is enabled:
=INFO EVENT-EXIT-PROCESS logon1
Interprocess Communication Messages
The Safeguard software communicates with the event-exit process by sending
messages using the standard file system procedure WRITEREAD[X]. The message
sent to the event-exit process is divided into three primary sections: Header_Data,
Subject_Data, and Message_Data.
Header_Data and Subject_Data have the same format for all message types although
the content of some fields can vary based on data availability. (For more information,
see Table 15-2 on page 15-15 and Table 15-3 on page 15-17.) The event-exit process
provides its response and status information by altering fields in the Header_Data and
returning it to the Safeguard subsystem. The event-exit process does not return the
Subject_Data. The event-exit process might return the Message_Response_Data,
depending on the type of event.
Message_Data sent by the Safeguard software has a different structure for each type
of event, as shown in Table
15-4 on page 15-18 through Table 15-6 on page 15-22.
The event-exit process replies to logon and password change events by overlaying the
Message_Data with message response data as shown in Table 15-7 on page 15-22
and Table
15-8 on page 15-23. It does not provide message response data for access
control or logon abort event
s.
The names of the data items in Table
15-2 on page 15-15 through Table 15-8 on
page 15-23 are pseudonames, and do not exactly match the names as specified in the
DDL. For variable names, see the DDL output. The DDL is located in the file
ZSAFEGRD.SEEPDDL.
Figure 15-2 illustrates the structure of the message buffer between the Safeguard
software and the event-exit process.
EVENT-EXIT-PROCESS = LOGON1
ENABLED = ON
RESPONSE-TIMEOUT= 15 SECONDS
TIMEOUT-ALL-AUTHZREQ = ON
ENABLE-AUTHENTICATION-EVENT = ON
ENABLE-AUTHORIZATION-EVENT = ON
ENABLE-PASSWORD-EVENT = OFF
PROG = $DEV.SECURE.EVENTS
LIB = * NONE *
NAME = $EVENTS2
SWAP = * NONE *
CPU = 3
PRI = 155
PARAM-TEXT = 4