CATALOGINFO Request

The CATALOGINFO request produces a hierarchical list of files, including the access and creation dates, the size in segments, the security class, the status, and the file kind. The CATALOGINFO request produces the same output as the FILENAMES request with the CATALOGUE modifier. Refer to “FILENAMES Request” in this section for more information. The output is sent to the printer by default.

Note: The report contains a FILE NUMBER for each file listed. However, 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.

<cataloginfo request> 

── CATALOGINFO ────────────────────────────────────────────────────────►
►─┬─────────────────────────────────────────────────────┬──────────────┤
  └─ : ─┬───────────────────────────────────────────────┤
        │ ┌◄──────────────────────────────────────────┐ │
        └─┴─┬─ ARCHIVE ─────────────────────────────┬─┴─┘
            ├─ BACKUPSN ── = ──<tape serial number>─┤
            ├─ DATABASE ────┬─ = ──<file title>─────┤
            ├─ GUARDFILE ───┤                       │
            ├─ DIRECTORY ───┤                       │
            ├─ NEWDATABASE ─┤                       │
            ├─ TITLE ───────┘                       │
            ├─<CODEVERSION modifier>────────────────┤
            ├─ ARCHIVEBACKUP ── = ─┬─ ANY ──────────┤
            │                      ├─ CURRENT ──────┤
            │                      ├─ NONCURRENT ───┤
            │                      └─ NONE ─────────┤
            ├─ DELETED ── = ──<family index number>─┤
            ├─ LEVEL ── = ──<integer>───────────────┤
            ├─<output option>───────────────────────┤
            ├─ FAMILYNAME ─┬─ = ──<family name>─────┤
            ├─ PACKNAME ───┘                        │
            ├─ NONRESIDENTONLY ─────────────────────┤
            ├─ RESIDENTONLY ────────────────────────┤
            ├─ RAWHEADERS ──────────────────────────┤
            └─ REMOVED ─────────────────────────────┘

Explanation

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

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

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

  • CODEVERSION

  • DATABASE

  • DELETED

  • DIRECTORY

  • FAMILYNAME

  • GUARDFILE

  • LEVEL

  • NEWDATABASE

  • NONRESIDENTONLY

  • PACKNAME

  • RAWHEADERS

  • REMOVED

  • RESIDENTONLY

  • TITLE

CATALOGINFO Example

The following example produces a CATALOGINFO report on the file ACCOUNTS and all files in the directory ACCOUNTS/=. 

RUN *SYSTEM/FILEDATA ("CATALOGINFO: TITLE = ACCOUNTS");

The following example produces a CATALOGINFO report on cataloged tape files. 

RUN *SYSTEM/FILEDATA("CATALOGINFO: FAMILYNAME = TAPE");
Prev  Up  Next
BACKUP Request  Home  CHECKERBOARD Request