Guardian Procedure Calls Reference Manual

desc-field-text:desctxtfld-maxlen
output:input
STRING .EXT:ref:*, INT:value
If present and when desctxtfld-maxlen is not zero, returns the contents of the textual
description field of the specified user/alias.
desctxt-len
output
INT .EXT:ref:*
Returns the actual length of the specified user's textual description field. This parameter is
required when desc-field-text:desctxtfld-maxlen is specified.
desc-field-bin:descbinfld-maxlen
output:input
STRING .EXT:ref:*, INT:value
If present and when descbinfld-maxlen is not zero, desc-field-bin returns the contents
of the binary description field of the specified user/alias.
descbin-len
output
INT .EXT:ref:*
Returns the actual length of the specified user's binary description field. This parameter is
required, when desc-field-bin:descbinfld-maxlen is specified.
Returned Value
INT
A file-system error code that indicates the outcome of the call. Common errors returned are:
No error. Default user information is returned as requested.0
Record not in file. The specified user name or user ID is undefined.11
Parameter out of bounds. An input parameter is not within the valid range, or return information does not fit
into the length of the space provided, or an output parameter supplied overlays the stack marker that was
created by calling this procedure.
22
Missing parameter. This procedure was called without specifying a required parameter.29
Bad parameter value. The value specified in user-curlen is greater than the value specified in
user-maxlen, or the value specified in user-curlen is not within the valid range, or the value specified
in user-id is not within the valid range.
590
For more information on file-system error messages, see the Guardian Procedure Errors and
Messages Manual.
Considerations
• Either user-id or user-name must be supplied. If both parameters are supplied and
user-curlen is greater than zero, then user-name is used and user-id is treated as an
output parameter. In this case, no attention is paid to the current contents of the user-id
parameter.
• For information on aliases or groups other than the primary group, or for OSS information,
Safeguard software must be installed. For more information on the Safeguard product, see
the Safeguard Reference Manual.
1456 Guardian Procedure Calls (T-V)