Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-34
USER_AUTHENTICATE_ Procedure
Values returned for error = 70 (continue dialog):
status-flags output
INT .EXT:ref:1
The bits, when set to 1, are defined as follows:
<0:14> Reserved.
<15> Caller should disable echo (with a SETMODE 20) for password input
before the next call during this dialog with USER_AUTHENTICATE_.
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
16 Password change request: new password does not conform to
password quality. New password is rejected.
17 Password change request: new password contains blank characters.
New password is rejected.
18 Password change request: new password is not verified. The first
new password provided is not the same as the second new password
provided.
19 Password change request: change cannot made during the allowed
time period. Password change request is rejected.
20 Password change request: change is denied due to a system error.
Retry later.
21
Cannot authenticate the super ID because
options bit <11> is set to
1.
status Description
4
Caller should set input
text to a password in the next call to
USER_AUTHENTICATE_ to either log on or begin a password
change.
9
Caller should set input
text to a new password in the next call to
USER_AUTHENTICATE_ to change the password.
11
Caller must set input
text 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.
12
Caller should set input
text to a new password in the next call to
USER_AUTHENTICATE_ to verify the new password.
status Description