Function

getpwnam invokes the getpwnam callable service to get information about a user, identified by user name.

Parameters

name

The user name as defined to the system.

stem

The name of a stem variable used to return the information. Upon return, stem.0 contains the number of variables returned. To access the information, you can specify a numeric value (see REXX predefined variables) or the predefined variable beginning with PW_ used to derive the appropriate numeric value. For example, to access the name of the user's initial working directory, you can specify stem.4 or stem.pw_dir:

Variable	Description
PW_DIR	The initial working directory
PW_GID	The group ID
PW_NAME	The TSO/E user ID
PW_SHELL	The name of the initial user program.
PW_UID	The user ID (UID) as defined to RACF®.

Usage notes

1. A RETVAL greater than zero indicates success. A RETVAL of -1 or 0 indicates failure. A RETVAL of 0 has an ERRNOJR, but no ERRNO.
2. If an entry for the specified name is not found in the user database, the RETVAL is 0.