Guardian Procedure Calls Reference Manual

dialog-id = value of dialog-id returned from the previous call
3. Check error and status return values and enable echo with SETMODE function 20.
• If error = 0 and status = 0, then the specified user is logged on.
• If error = 0 and status = 8, then the specified user is logged on but the password is
about to expire. The caller displays a message telling the user to change the password
by the time-password-expires value.
• If error = 0 and status = 22, then the specified user is logged on. The password was
about to expire, and since the caller already passed in the new password along with the
current password (password, newpassword, newpassword), the password was successfully
changed to newpassword.
• If error = 0 and status = 23, then the specified password is long and the
PASSWORD-COMPATIBILITY-MODE is set to ON. The first eight characters of the specified
password have been accepted as the new password. If the longer password contains the
embedded blank spaces and invalid characters even after the eighth place, the password
will be rejected though the PASSWORD-COMPATIBILITY-MODE is set to ON.
• If error = 70 and status = 11, then the specified user is not logged on because the
password has expired. The caller displays a message telling the user that logon is denied
due to password expiration. Another application could continue the dialog and prompt
for a new password sequence.
Related Programming Manuals
For programming information on the command-interpreter monitor process ($CMON), see the
Guardian Programmer's Guide. For more information on the Safeguard product, see the Safeguard
Reference Manual.
USER_AUTHENTICATE_ Procedure 1451