Guardian Procedure Calls Reference Manual

Descriptionstatus
Caller must set inputtext to a new password in the next call to USER_AUTHENTICATE_ to change the
password, because the password has expired but the grace period is in effect. If the password is not
changed, the user is not authenticated or logged on.
11
Caller must set inputtext to a new password in the next call to USER_AUTHENTICATE_ to verify the
new password.
12
status-flags
output
INT .EXT:ref:1
The bits, when set to 1, are defined as follows:
Reserved.<0:14>
Caller must disable echo (with SETMODE function 20) for password input before the next call during this
dialog with USER_AUTHENTICATE_.
<15>
displaytext:displaytext-maxlen
output:input
STRING .EXT:ref:*, INT:value
if present and if displaytext-maxlen is not 0, returns a string, up to
displaytext-maxlen bytes in length, representing one or more lines of logon dialog display
text. Each line of text is preceded by a 16-bit length that is 16-bit aligned. The last line of text
is followed by a byte length of 0 to indicate that there are no more display lines. Display text,
generated by $CMON or Safeguard software, can be returned anytime during a dialog.
displaytext-maxlen is a value in the range 0 through 2048.
This parameter pair is required if displaytext-len is specified.
displaytext-len
output
INT .EXT:ref:1
if displaytext is returned, contains its actual length in bytes.
This parameter is required if displaytext:displaytext-maxlen is specified.
cmon-timeout
input
INT:value
specifies how many seconds the procedure waits for $CMON to respond with pre-logon and
logon messages. A value of 0 causes the procedure to wait indefinitely. The default value is
30 seconds. This parameter is ignored when Safeguard software is running.
termname:termname-len
input:input
STRING .EXT:ref:*, INT:value
if supplied and if termname-len is not 0, is a file name that specifies the terminal for
interaction with the security mechanism. If used, the value of termname must be exactly
termname-len bytes long. If termname is partially qualified, it is resolved using the
=_DEFAULTS DEFINE.
The default value is the home terminal of the caller.
USER_AUTHENTICATE_ Procedure 1445