z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Exit Values
Portability
v LC_SYNTAX
v NLSPATH
See Appendix F for more information.
0 Successful completion
1 Failure due to any of the following:
v Error setting termios attributes
v Unknown mode
v Missing number after option
v Argument out of range
v Bad number after option
v Internal error
v Error reading termios attributes
v Missing character after option
v Badly formed argument option character
v Missing speed after ispeed or ospeed
v Bad speed argument
POSIX.2, UNIX System V.
su — Change the user ID associated with a session
Format
Description
su [–] [–s][userid [arg ...]]
su starts a new shell and lets you operate in it with the privileges of a superuser or
another user.
If you do not specify a user ID, su changes your authorization to that of the
superuser. If you specify a user ID, su changes your authorization to that of the
specified user ID. The new environment is built and then a new session is initiated.
The new session is run as a child shell of the shell issuing the su command.
Any arguments specified by arg are passed to the child shell, so must be valid
invocation flags or arguments accepted by the child shell.
su performs these functions:
v Obtains your user profile information. After validating that you have an OMVS
segment in the user profile, the OMVS segment information is obtained.
v Verifies authorization. If a user ID is not specified, you must have the
appropriate authorization to obtain superuser authority. You must be permitted to
the BPX.SUPERUSER resource in the FACILITY class. For more information,
see z/OS UNIX System Services Planning.
stty
If a user ID is specified, and you do not have read access to the SURROGAT
class profile, BPX.SRV.uuuuuuuu (where uuuuuuuu is the MVS userid associated
with the target UID), you must enter the target user’s password when prompted.
If a user ID is specified, and you have read access to the SURROGAT class
profile for the target user, you can use the –s option, or press Enter at the
password. For more information see z/OS UNIX System Services Planning.
Chapter 2. Shell command descriptions 607