CLIST - verbose catalog lister.

Syntax:

clist [pathname|option]*

(+|-)ALlsize (+)     (+|-)Attributes (+) (+|-)Busy (+)
(+|-)Catalogs (+)    (+|-)Dates (-)      (+|-)Extents (-)
(+|-)Files (+)       (+|-)Headings (-)   (+|-)Nonstruct (+)
(+|-)Originators (+) (+|-)PAsswords (-)  (+|-)PErmissions(+)
(+|-)Privileged (-)  (+|-)Rawdump (-)    (+|-)Summary
(+|-)Userinfo (+)    (+|-)Verbose        Levels=number (10)

Examples:

clist umcname level=0
clist /file +Verbose

Options:

pathname: is the name of the file system structure you want to list. If this name begins with a slash, it is considered to be relative to the user's current catalog. Otherwise, the first field is taken as a userid.
+ALlsize: includes all files in the total filespace count, even if they were not listed because of a -Files or -Catalogs option. This is the default. Files not listed because of the Levels= option are NOT included in this total size.
-Attributes: does not report the settings of various attributes that the file or catalog may have, e.g. security locks and the "no save" flag.
-Busy: does not display busy counts for files.
+Catalogs: lists the catalogs in the substructure, up to the level specified by the Levels= option. This is the default.
-Catalogs: lists only files, although subcatalogs containing files are still added to the total filespace unless you also specify -ALlsize.
+Dates: displays extra date information. This includes date of creation, most recent modification (to attributes, e.g. permissions), most recent change of contents, and most recent access. Times are also provided for creation and change, if they are available. In order to accommodate this extra information, the output for each file is split into two lines.
+Extents: lists the number of extents occupied by each file.
+Files: includes files in the listing. This is the default.
-Files: does not list files. Files not listed because of -Files are still included in the filespace total, unless you also specify -ALlsize.
+Headings: displays a heading before the listing.
Levels=number: specifies the maximum depth to be listed, relative to the given pathname. Files not listed because they are too deep are NEVER included in the filespace totals.
-Nonstruct: does not display information about non-structured files. Non-structured files are used to catalogue tapes, and also to indicate files that are handled by the Automatic Storage Manager (ASM).
-Originators: does not display the originator of a structure, even if the originator differs from the owner.
+PAsswords: displays passwords if they are non-null. This option is privileged.
-PErmissions: does not list specific permissions on files.
+Privileged: tells CLIST to ignore security locks and denied permissions when deciding what to list. This option is privileged.
+Rawdump: dumps the catalog blocks as they are encountered. This option is privileged.
+Summary: displays a summary line at the end of the listing for each structure. The default is to only do this for catalogs.
+Userinfo: displays the user specified information word in an appropriate format.
+Verbose: implies +Headings, +Dates and +Extents.
-Verbose: implies -Attributes, -Busy, -Nonstruct, -Originators, -Userinfo, -Summary and -PErmissions.

Description:

The CLIST command provides a verbose listing of file and catalog characteristics. You specify options to tell CLIST which characteristics to list. The option settings apply to all pathnames on the command line.

If you do not specify a Summary option on the command line, CLIST displays a summary for every catalog but not for individual files. If you specify +Summary, CLIST displays a summary for every item. If you specify -Summary, CLIST does not display any summary lines.

CLIST Output:

Without the +Dates option, a typical line of CLIST output looks like

name  dx6 s rwae     4c   53 092182 021186 21:11   7c *fs703

This has the following parts.

Name of the file or catalog.
Device where the file or catalog is found (dx6 in the example).
"s" for a sequential file; "r" for a random file; blank for catalog
Letters showing general permissions on file or catalog. In the above example, "rwae" shows general Read, Write, Append, and Execute permissions. For more about permissions, see "expl file system".
Size of file in llinks. In the example, the size is 4 llinks. This is followed by the letter "c" if the file occupies contiguous space on the disk, or the letter "n" if the file has no contents.
Maximum size set for file. If there is no such maximum, CLIST prints "u" for "unlimited".
Date file or catalog was created, given as "mmddyy". In the above example, "092182" indicates the file was created September 21, 1982.
Date file or catalog was last modified, given as "mmddyy". In the above example, "021186" indicates the file was last modified February 11, 1986.
Time file or catalog was last modified. This has the form "hh:mm" and uses a 24-hour clock. Thus 21:11 means 9:11 p.m.
Number of times file has been accessed since its creation. This is followed by a letter indicating the access class of the file:

" " - ACCESS/NORMAL/

There is no concurrent read/write access.

"w" - ACCESS/READWHILEWRITE/

One writer can share this file with multiple concurrent readers.

"c" - ACCESS/CONCURRENT/

Multiple concurrent readers and writers can share this file.

"m" - ACCESS/MONITOR/

Multiple concurrent readers and writers can share this file, but there is system monitoring to resolve conflicting actions. This monitoring service is not available to programs in TSS.
The back-up tape where the file was last saved. In the above example, this is "fs703". The back-up tape label is preceded by a "*" (as shown above) if the file has been changed since it was backed up.

When you use the +Dates option, there will be (at least) two lines per file or catalog instead of only one.

name      r              6     53  DATES
     st1  save:bkxx5*   1ext  seq  TIMES  100 c

The first line gives (in order) the name, the general permissions, the current file size, and the maximum file size ("u" for unlimited). After that come four dates:

the date the file/catalog was created
the date its attributes were last modified (e.g. permissions changed)
the date its contents were last changed
the date it was last accessed (read or write)

Dates are shown in the format "DD/MMM/YY", as in "23/Sep/88". On the next line, the time of creation and the time of the most recent change are shown below their respective dates. The time given for the most recent change will be the time at which the operation FINISHED (i.e. when the file was de-accessed). Because GCOS8 only recently started recording create times as well as dates, early dates will not have associated times.

The second line begins with the device that holds the file, the most recent save tape, the number of extents, and whether the file is sequential or random. The second line ends with the the number of accesses to date, and a character indicating the access class of the file.