Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-30
USER_AUTHENTICATE_ Procedure
70 Continue dialog. See the status parameter for detailed information on
how to set the input
text parameter in the next call to
USER_AUTHENTICATE_.
160 Invalid
dialog-id parameter, invalid protocol, or dialog has exceeded
two minutes.
563 The text to be returned in the
displaytext parameter is longer than the
length specified by the
displaytext-maxlen parameter.
590 Two or more parameters provided are incompatible.
1554 Exceeded the maximum number of allowed concurrent requests.
Refer to the
Guardian Procedure Errors and Messages Manual for more
information on file-system error messages.
input
text:inputtext-len input:input
STRING .EXT:ref:*, INT:value
specifies a user and password command string. If a dialog is not desired,
input
text must contain all the information necessary to complete the user
authentication in a single call to the procedure.
input
text-len specifies the length of the string variable inputtext in bytes.
Only the first 80 characters of the string are used. This procedure does not return
an error if the string exceeds 80 bytes in length.
See “Considerations” following, for information on how to set input
text to
authenticate a user, log on, or change a password.
options input
INT:value
specifies additional requests of the USER_AUTHENTICATE_ procedure.
The bits, when set to 1, are defined as follows:
<0:6> Reserved (specify 0).
<7> Require password for all users (including the super ID).
<8> 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 for blind
logon. Otherwise, USER_AUTHENTICATE_ returns with
error equal to
48 (security violation) and
status equal to 4.
<9> 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.