Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-56
USERNAMETOUSERID Procedure
(Superseded by USER_GETINFO_ Procedure )
USERNAMETOUSERID Procedure
(Superseded by USER_GETINFO_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Summary
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
•
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
Parameters
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:
name-id FOR 4 group name, blank-filled
name-id[4] FOR 4 member name, blank-filled
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:
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(USERNAMETOUSERID)>
_cc_status USERNAMETOUSERID ( short _near *name-id );
CALL USERNAMETOUSERID ( name-id ); ! i,o