Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-35
USER_AUTHENTICATE_ Procedure
aligned. The last line of text is followed by a byte length of 0 to indicate that there
are no more display lines. Display text, generated by $CMON or Safeguard
software, can be returned anytime during a dialog.
displaytext-maxlen is a value in the range 0 through 256.
This parameter pair is required if
displaytext-len is specified.
displaytext-len output
INT .EXT:ref:1
if
displaytext is returned, contains its actual length in bytes.
This parameter is required if
displaytext:displaytext-maxlen is specified.
cmon-timeout input
INT:value
specifies how many seconds the procedure should wait for $CMON to respond
with pre-logon and logon messages. A value of 0 causes the procedure to wait
indefinitely. The default value is 30 seconds. This parameter is ignored when
Safeguard software is running.
termname:termname-len input:input
STRING .EXT:ref:*, INT:value
if supplied and if
termname-len is not 0, is a file name that specifies the terminal
for interaction with the security mechanism. If used, the value of
termname must
be exactly
termname-len bytes long. If termname is partially qualified, it is
resolved using the =_DEFAULTS DEFINE.
The default value is the home terminal of the caller.
volsubvol:volsubvol-maxlen output:input
STRING .EXT:ref:*, INT:value
if present and if
volsubvol-maxlen is not 0, returns the name of the default
volume and subvolume inherited by the specified user when a logon session is
initiated. This information is returned in external form.
volsubvol-maxlen specifies the length of the string variable volsubvol in
bytes.
This parameter pair is required if
volsubvol-len is specified.
volsubvol-len output
INT .EXT:ref:1
if
volsubvol is returned, contains its actual length in bytes.