FILENAMES Request

The FILENAMES request produces a hierarchical list of files, including access and creation dates, size in segments, security class, status, and file kind. The output is sent to the printer by default.

The FILENAMES request reports only on resident files unless the ARCHIVE, CATALOGUE, LIBMAINTDIR , or TAPE modifier is used.

If the output is written to a disk file, the LINEWIDTH value specified in the DEFINEOUTPUT request must be 132.

The report includes a file number that is the number of the file in the FILEDATA database unless:

  • the CONTAINER or LIBMAINTDIR option is specified when the number listed in the report refers to the container file number or the library maintenance tape file number

  • the database was generated by another task request with the CONTAINER, LIBMAINTDIR, or TAPEHEADER option when the number listed in the report refers to the container file number or the library maintenance tape file number

If there are numbers missing from the report, it could mean

  • You specified some FILEDATA modifiers to select only certain files.

  • Library maintenance did not copy all the files in the original COPY statement to the tape.

  • In the case of the TAPEHEADER option, FILEDATA started reading from a tape volume other than the first tape volume.

  • Resident or nonresident files that are not reported are being indicated.

For all other cases, the file number shown in the report is the number of the file in the FILEDATA database, not the number of the file in the report. The file number column accommodates numbers up to and including 999,999. Any number larger than 999,999 is truncated to the left.

<file names request> 

── FILENAMES ────────────────────────────────────────────────────────────────►
►─┬────────────────────────────────────────────────────────────────────────┬─┤
  └─ : ─┬──────────────────────────────────────────────────────────────────┤
        │ ┌◄─────────────────────────────────────────────────────────────┐ │
        └─┴─┬─ ARCHIVE ────────────────────────────────────────────────┬─┴─┘
            ├─ BACKUPSN ── = ──<tape serial number>────────────────────┤
            ├─ CATALOGUE ──────────────────────────────────────────────┤
            ├─ CONTAINER ─┬─ = <file title> ─┬─────────────────────────┤
            ├─ DIRECTORY ─┤                  ├─ (CD) ──────────────────┤
            ├─ TITLE ─────┘                  └─ (CDROM) ───────────────┤
            ├─ DATABASE ────┬─ = ──<file title>────────────────────────┤
            ├─ GUARDFILE ───┤                                          │
            ├─ NEWDATABASE ─┘                                          │
            ├─<CODEVERSION modifier>───────────────────────────────────┤
            ├─ ARCHIVEBACKUP ── = ─┬─ ANY ─────────────────────────────┤
            │                      ├─ CURRENT ─────────────────────────┤
            │                      ├─ NONCURRENT ──────────────────────┤
            │                      └─ NONE ────────────────────────────┤
            ├─ DELETED ── = ──<family index number>────────────────────┤
            ├─ LEVEL ── = ──<integer>──────────────────────────────────┤
            ├─ LIBMAINTDIR ── = <file title> ──────────────────────────┤
            ├─ NAMESONLY ──────────────────────────────────────────────┤
            ├─<output option>──────────────────────────────────────────┤
            ├─ FAMILYNAME ─┬─ = ──<family name>─┬──────────────────────┤
            ├─ PACKNAME ───┘                    ├─ (CD) ───────────────┤
            │                                   └─ (CDROM) ────────────┤
            ├─ RAWHEADERS ─────────────────────────────────────────────┤
            ├─ REMOVED ────────────────────────────────────────────────┤
            ├─ NONRESIDENTONLY ────────────────────────────────────────┤
            ├─ RESIDENTONLY ───────────────────────────────────────────┤
            ├─ TAPE ── = ─┬─<unit number>───────────────────┬─┬────────┤
            │             └─<tape name>─┬───────────────────┤ └─ SORT ─┤
            │                           ├─ ( ── CD ── ) ────┤          │
            │                           └─ ( ── CDROM ── ) ─┘          │
            ├─ TAPEHEADERS ────────────────────────────────────────────┤
            └─ WRAPPEDFILES ───────────────────────────────────────────┘

Explanation

For more information about <output option> refer to “Output Options” earlier in this section.

Note: If you use the FILENAME output option with FILENAMES, then precede the FILENAMES request with a DEFINEOUTPUT request that sets LINEWIDTH = 132. Otherwise, the record size defaults to 80 bytes, which is too short for a FILENAMES report.

SORT

Causes FILEDATA to sort the file names from the specified tape in the same order that files on disk are reported. SORT does not work if TAPEHEADERS is selected.

FILEDATA Modifiers

The following FILEDATA modifiers perform functions such as selecting the disk family or file names to be reported on, and specifying the types of information to be reported for each file. These modifiers are explained under “FILEDATA Modifiers” later in this section.

  • ARCHIVE

  • ARCHIVEBACKUP

  • BACKUPSN

  • CATALOGUE

  • CODEVERSION

  • CONTAINER

  • DATABASE

  • DELETED

  • DIRECTORY

  • FAMILYNAME

  • GUARDFILE

  • LEVEL

  • LIBMAINTDIR

  • NAMESONLY

  • NEWDATABASE

  • NONRESIDENTONLY

  • PACKNAME

  • RAWHEADERS

  • REMOVED

  • RESIDENTONLY

  • TAPE

  • TAPEHEADERS

  • TITLE

  • WRAPPEDFILES

FILENAMES Examples

The following example produces a FILENAMES report on all the files specified in the file UTILITYDB. UTILITYDB is a file created by the NEWDATABASE modifier in a previous FILEDATA run. 

RUN *SYSTEM/FILEDATA ("FILENAMES: DATABASE = UTILITYDB");

The following example produces a report of all the nonresident files for the family PACK under the usercode UCX that have archive backup copies, catalog backup copies, or both on tape: 

RUN *SYSTEM/FILEDATA ("FILES: DIR=USERCODE/UCX
                       FAMILY=PACK NONRESIDENTONLY")

The following example produces a FILENAMES report on the file MYFILES. The report is written to the disk file FDREPORT and is formatted with a line width of 132 characters. 

RUN *SYSTEM/FILEDATA ("DEFINEOUTPUT:LINEWIDTH=132;
FILENAMES:TITLE=MYFILES FILENAME=FDREPORT");
Prev  Up  Next
DEFINEOUTPUT Request  Home  HEADERCONTENTS Request