LISTUSER



LISTUSER

    Displays information for one or more users.  (CM)


SYNTAX



LISTUSER [userset][,listfile][;PASS]
[;FORMAT={SUMMARY|BRIEF|DETAIL}]


PARAMETERS



userset Specifies the set of users to be listed.
The default is all (@) users (and accounts)
within the user's capabilities (AM or SM).
Use wildcard characters to specify more than
one user. Use the ? symbol to specify a
single alphanumeric character. Use the #
symbol to specify a single numeric
character. Use the @ symbol to specify zero
or more alphanumeric characters.

listfile The name of the output file. The default is
$STDLIST, a temporary file that cannot be
overwritten by a BUILD command. It is
automatically specified as a new ASCII file
with variable-length records, closed in the
temporary domain, user-supplied
carriage-control characters (CCTL), OUT
access mode, and EXC (EXCLUSIVE access)
option. All other characteristics are the
same as they would be with the FILE command
default specifications.

PASS Permits users with account manager (AM) and
System Manager (SM) capability to see the user password.


FORMAT Used to specify one of several display formats.

SUMMARY Provides a summary of information.
If FORMAT is not specified, SUMMARY
is the default.

BRIEF Generates a list of

DETAIL Displays all information associated with
the account.

OPERATIONS

     This command produces user information in an ASCII format.

     This command is available from a session, job, program,
     or in BREAK.  Pressing [[Break]] aborts the execution of
     this command.  If you do not have System Manager (SM) or
     account manager (AM) capability, you can list only your
     logon user.  If you have AM, you may list any user
     in your account.  If you have SM, you may list any user in
     the system.




EXAMPLE(S)

In the following example, since the user has AM capability, the
password is displayed:


LISTUSER PETE;PASS

...or...

LISTUSER PETE;PASS;FORMAT=SUMMARY

**********************************

USER: PETE.TEST

HOME GROUP: DEVELOP                  PASSWORD: MYPASS
MAX PRI   : 150                      LOC ATTR: $00000000
LOGON CNT : 1                               WRITE   : GU
CAP: AM,AL,GL,DI,CV,UV,LG,CS,ND,SF,IA,BA,PH,DS,MR,PM
****************************



LISTUSER @;FORMAT=BRIEF
PETE.TEST
MIKE.TEST
CHRIS.TEST

**************************

In the following example, the "##" in the UID and GID fields indicate
that no UID or GID are associated with the user.  The PXUTIL utility
should be run to create UID and GID entries.

LISTUSER PETE;FORMAT=DETAIL


USER       : PETE.TEST
PASSWORD   : **
UID        : ##
GID        : ##
MAX PRI    : 150
LOC ATTR   : $00000000
LOGON CNT  : 2
HOME DIR   : /UI/DEVELOP
LOGON CI   : /SYS/PUB/CI
USER INFO  : Comment field to be filled in
CAP        : AM,AL,GL,DI,CV,UV,LG,PS,CS,ND,SF,BA,IA,PM,MR,DS,PH

***********************


ADDITIONAL INFORMATION

Commands:  ALTUSER, LISTACCT, LISTGROUP, NEWUSER, PURGEUSER