Guardian Procedure Calls Reference Manual

USERNAMETOUSERID 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 USERNAMETOUSERID procedure returns the user ID, from the file $SYSTEM.SYSTEM.USERID,
that is associated with a designated user name.
Syntax for C Programmers
#include <cextdecs(USERNAMETOUSERID)>
_cc_status USERNAMETOUSERID ( short _near *name-id );
• The function value returned by USERNAMETOUSERID, 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 USERNAMETOUSERID ( name-id ); ! i,o
Parameter
name-id
input, output
INT:ref:8
on input, contains the user name to be converted to a user ID. The user name is passed in the
form:
group name, blank-filled4FORname-id
member name, blank-filled4FORname-id[4]
The group name and member name must both be input in uppercase.
On the return, contains the user ID associated with the specified user name in the form:
{0:255}group ID.<0:7>name-id
{0:255}member ID.<8:15>
1478 Guardian Procedure Calls (T-V)