Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
error := USER_AUTHENTICATE_ ( inputtext:inputtext–len ! i:i
,[ options ] ! i
,[ dialog-id ] ! i,o
,[ status ] ! o
,[ status-flags ] ! o
,[ displaytext:displaytext-maxlen ] ! o:i
,[ displaytext-len ] ! o
,[ cmon-timeout ] ! i
,[ termname:termname-len ] ! i:i
,[ volsubvol:volsubvol-maxlen ] ! o:i
,[ volsubvol-len ] ! o
,[ initdir:initdir-maxlen ] ! o:i
,[ initdir-len ] ! o
,[ initprog:initprog-maxlen ] ! o:i
,[ initprog-len ] ! o
,[ initprog-type ] ! o
,[ last-logon-time ] ! o
,[ time-password-expires ] ); ! o
,[ ipaddress:ipaddress-len ] ); ! i:i
Parameters
inputtext:inputtext-len
input:input
STRING .EXT:ref:*, INT:value
specifies a user and password parameter string. If a dialog is not desired, inputtext must
contain all the information necessary to complete the user authentication in a single call to the
procedure.
inputtext-len specifies the length of the string variable inputtext in bytes. Only the
first 256 characters of the string are used. This procedure does not return an error if the string
exceeds 256 bytes in length.
For information on how to set to authenticate a user, log on, or change a password, see
Considerations (page 1448).
options
input
INT:value
specifies additional requests of the USER_AUTHENTICATE_ procedure.
The bits, when set to 1, are defined as follows:
Reserved (to be specified as 0).<0:1>
Enable PRIV-LOGON for users or aliases. It allows the program file to logon as a user or alias when
password is not supplied. No time delay is enforced on failure of USER_AUTHENTICATE_ to verify the
user or alias with an invalid password.
<2>
Reserved (specify 0).<3>
This bit is applicable only while setting and changing the long password (contains more than eight
characters) using the USER_AUTHENTICATE_ procedure call. On all other events, this bit is ignored.
<4>
Reserved (specify 0).<5:6>
Require password for all users (including the super ID).<7>
This bit must be set if USER_AUTHENTICATE_ is not being used in dialog mode (that is, only a single call
to USER_AUTHENTICATE_ is being done) and either the blind logon bit is set or Safeguard is configured
<8>
for blind logon. Otherwise, USER_AUTHENTICATE_ returns with error equal to 48 (security violation)
and status equal to 4.
Send $CMON the Prelogon^msg message (-59). This bit is valid either when Safeguard software is
running and configured with CMON ON or when Safeguard software is not running.
<9>
1442 Guardian Procedure Calls (T-V)