Accessing Files Programmer's Guide (32650-90885)

Chapter 14 189
Getting File Information
Displaying General File Information
Specifying the list level
If you do not indicate otherwise, LISTFILE displays only the unqualified file name. You can
optionally direct LISTFILE to display more detailed information about the file(s) that you
specify, depending upon the parameter value that you specify in the command, as listed in
Table 14-1. on page 189
Table 14-1. Format Selection
Option Name Displayed Information
−2 ACD Displays the file's ACD (access control definition). System
managers can view the ACD for any file. Account managers can
view the ACD for files in that account. File creators can view the
ACD for their files. Other users can view an ACD only if that ACD
specifies that the user has RACD (read ACD) access.
−1 LABEL Displays the hexadecimal listing of the file label, including all
lockwords. This level is available only to system managers and
account managers.
0 FILES Shows only the file name. This is the default.
1 SUMMARY Displays the file name, file code, record size, record format, and
other file characteristics such as ASCII or binary records,
carriage-control option, current end-of-file location, and the
maximum number of records allowed in the file.
2 DISC Displays the file name, file code, record size, record format, and
other file characteristics such as ASCII or binary records,
carriage-control option, current end-of-file location, and the
maximum number of records allowed in the file. It also displays the
blocking factor, number of sectors in use, number of extents
currently allocated, and the maximum number of extents allowed.
LISTF, 2 also displays KSAM XL file types with "K", and KASAM64
with “K”..
3 DETAIL Displays the file name, record size, extent size, number of records,
access rights for the user, and other file characteristics including
the date created, modified, and last accessed. The creator, lockword,
and label address are omitted. These can be obtained by specifying
-3 if you have AM capability (for files in your account) or SM
capability (for any file on the system).
4 SECURITY Displays the security matrix for the file. This includes account-,
group- and file-level security and the access rights for the user. If an
access control definition exists (ACD), a message stating that fact is
displayed.
5 DATA Shows LISTFILE,3 data and all file-specific data in LISTF, 3 type
format (that is, KSAM and SPOOL).
6 QUALIFY Shows only fully qualified file name.
7 UNIQUE Shows all file specific datain LISTFILE,3 type format,but does not
show LISTFILE,3 data.