Guardian Procedure Calls Reference Manual

is-alias
input, output
INT .EXT:ref:1
on input, indicates whether the user-name input parameter contains a user name or an alias.
This parameter can be set to these values:
user-name is a user name.0
nonzerouser-name is an alias.nonzero
On output, indicates whether the user-name output parameter contains a user name or an
alias. This parameter returns these values:
user-name is an alias.-1
user-name is a user name.0
Returned Value
INT
A file-system error code that indicates the outcome of the call. Common errors returned are:
No error.0
Record not in file. The specified user-name 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 overlays the stack marker that was created by
calling this procedure.
22
Missing parameter. This procedure was called without specifying all parameters.29
Bad parameter value. Either 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.
590
For more information on file-system error messages, see the Guardian Procedure Errors and
Messages Manual.
Considerations
• Aliases are defined only when Safeguard software is installed.
• This procedure returns a user name when is-alias is set to 0 on input and when is-alias
returns 0 on output.
• This procedure returns an alias when is-alias is not set to 0.
• When the names are returned, user names are returned first and aliases are returned last.
Furthermore, the return sequence is not circular: a user name never follows an alias. User
names are not returned in any particular order, and the order can change from one RVU to
the next. Similarly, aliases are not returned in any particular order and the order can change
from one RVU to the next.
Example
! put all user names on a system into name^list and
! put all aliases on a system into alias^list
error := 0;
is^alias := 0;
name^entry := 0;
search^len := 0;
WHILE (error <> 0 and NOT is^alias) DO
BEGIN
USER_GETNEXT_ Procedure 1459