LISTGROUP


LISTGROUP

          Displays information for one or more groups.  (CM)


SYNTAX



LISTGROUP [groupset][,listfile][;PASS]
[;FORMAT={SUMMARY|BRIEF|}]




PARAMETERS



groupset Specifies the set of groups to be listed.
For account managers (AM) and system
managers (SM), the default is all (@) groups
within the user's logon account; for general
users, the default is the logon group. You
may use wildcard characters to specify more
than one group. Use the ? symbol to specify
a single alphanumeric character Use the #
symbol to specify a single numeric character.
Use the @ symbol to specify all
combinations of valid characters. You may
also specify group.account if you have
System Manager (SM) capability.

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, and with 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 AM and SM capability to
see the group 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
group.account names only.




OPERATIONS

          This command produces group 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 account manager (AM) or system
manager (SM) capability, you can list only your logon group.
Users with AM capability may list any group in their account.
Users with SM capability may list any group in the system.



EXAMPLE(S)

          In the following example, since the user does not have AM
or SM capability, the password does not appear in the display.


LISTGROUP DEVELOP;PASS;FORMAT=SUMMARY

*************************
LISTGROUP: DEVELOP.TEST

DISC SPACE: 5752(SECTORS) PASSWORD: **
CPU TIME : 0(SECONDS) SECURITY--READ : GU
CONNECT TIME: 0(MINUTES) WRITE : GU
DISC LIMIT: UNLIMITED APPEND : GU
CPU LIMIT : UNLIMITED LOCK : GU
CONNECT LIMIT: UNLIMITED EXECUTE : GU
PRIV VOL : n/a SAVE : GU
FILE UFID: $000D4001 $80001050 $000FF620 $00000008 $0000000A
MOUNT REF CNT: n/a
HOME VOL SET : MPE_SYS_VOL_SET
CAP: IA,BA
****************************

LISTGROUP @.@;FORMAT=BRIEF


ACCOUNT1.PAYROLL
ACCOUNT2.PAYROLL
DEVELOP.TEST
DOC.MASTER
JONES.TEST
PUB.SYS


ADDITIONAL INFORMATION

Commands:   ALTGROUP, LISTACCT, LISTUSER, NEWGROUP, PURGEGROUP