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.
Copyright © 1996, Thinkage Ltd.