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

Table Of Contents
Event-Exit-Process Commands
Safeguard Reference Manual 520618-030
15 - 21
Interprocess Communication Messages
Table 15-6 on page 15-22 shows the structure of the message data sent from the
Safeguard subsystem to the event-exit process for a password change event. This
message data is present only for a password change event resulting from an attempt
to change a password with the PASSWORD program or with the Safeguard ADD
Logon_Name_Phrase VAR-
STRING
The user name string typed by the user. If
the user entered a password, also includes
the password phrase, separated from the
name by a comma. Maximum length is 256
bytes. This is the string from which the
Logon_Name and Logon_UserID are
decomposed. The field is present only when
the caller is USER_AUTHENTICATE_.
This field is blank if the caller was
VERIFYUSER.
Password_Response_Phrase VAR-
STRING
The user’s response to a challenge or
p
assword request. Maximum length is 80
bytes.
This field is blank if the caller is
VERIFYUSER.
Logon_Attempts_Num INT The current number of unsuccessful logon
a
ttempts for this user ID. It is the number of
unsuccessful logon attempts since the last
successful logon attempt.
Authenticate_Only BOOLEAN Indicates a request from VERIFYUSER or
USER_AUTHE
NTICATE_ for information
only. True indicates information request.
False indicates logon request.
Options_Word INT The logon options word that was passed to
USER_AUTHENTICA
TE_, bits 2-15. Bits 0
and 1 of the options word are always zero.
IP_Address VAR-
STRING
The IP address of the client if provided by the
caller of t
he User_Authenticate_ API.
The IP address can be either IPv4 or IPv6
with ma
ximum length of 128 bytes.
The field is blank if the IP address is not
specified by the caller of User_Authen
ticate_
API.
FEA 24 bytes A future expansion area; currently populated
wi
th zeros.
Note.
IP_Address attribute is supported only on systems running on J06.16 and later J-series
RVUs, and H06.27 and later H-series RVUs.
Table 15-5. Logon_Data (Logon Message_Data
Interactive/Programmatic) (page 2 of 2)