Guardian Procedure Calls Reference Manual

USERIDTOUSERNAME Procedure (Superseded by USER_GETINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development. This procedure does not support aliases or groups.
The USERIDTOUSERNAME procedure returns the user name, from the file $SYSTEM.SYSTEM.USERID,
that is associated with a designated user ID.
Syntax for C Programmers
#include <cextdecs(USERIDTOUSERNAME)>
_cc_status USERIDTOUSERNAME ( short _near *id-name );
• The function value returned by USERIDTOUSERNAME, which indicates the condition code,
can be interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the
file tal.h).
Syntax for TAL Programmers
CALL USERIDTOUSERNAME ( id-name ); ! i,o
Parameter
id-name
input, output
INT:ref:8
on input, contains the user ID to be converted to a user name. The user ID is passed in the
form:
{0:255}group ID.<0:7>id-name
{0:255}member ID.<8:15>
On the return, contains the user name associated with the specified user ID in the form:
group name, blank-filled4FORid-name
member name, blank-filled4FORid-name[4]
USERIDTOUSERNAME Procedure (Superseded by USER_GETINFO_ Procedure) 1475