Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-64
VERIFYUSER Procedure
(Superseded by USER_AUTHENTICATE_
•
Following a successful logon with this procedure, the calling process is considered
local with respect to the system on which it is running.
•
A process that passes an invalid password to VERIFYUSER for the third time is
suspended for 60 seconds.
•
Note that each call to VERIFYUSER always results in an open, KEYPOSITION,
READUPDATEUNLOCK, WRITEUPDATEUNLOCK, and close operation on the
USERID file.
•
System users are defined through the TACL ADDUSER command. All TACL
commands are described in the
TACL Reference Manual.
Example
USER := 3 '<' 8 + 17; ! user ID 3,17.
USER[1] ':=' 0 & USER[1] FOR 6; ! all zeros.
USER[8] ':=' password FOR 8;
LOGON := 1; ! log this user on.
CALL VERIFYUSER ( USER , LOGON , DEFAULT , DEFAULT^LEN );
IF < THEN ... ! buffer or I/O error,
ELSE IF > THEN ... ! no such user, or bad
! password.
ELSE ... ! successful. .
The array “USER” is prepared with the member and group ID and then passed to
VERIFYUSER. VERIFYUSER logs on the process with the member ID 17 and group
ID 3.