Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-54
USERIDTOUSERNAME Procedure
(Superseded by USER_GETINFO_ Procedure )
USERIDTOUSERNAME Procedure
(Superseded by USER_GETINFO_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Summary
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
•
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
Parameters
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:
id-name.<0:7> group ID {0:255}
.<8:15> member ID {0:255}
on the return, contains the user name associated with the specified user ID in the
form:
id-name FOR 4 group name, blank-filled
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.
#include <cextdecs(USERIDTOUSERNAME)>
_cc_status USERIDTOUSERNAME ( short _near *id-name );
CALL USERIDTOUSERNAME ( id-name ); ! i,o