ARCHIVEINFO Request

The ARCHIVEINFO request produces a hierarchical list of files, including the access and the creation dates, the size in segments, the security class, the status and the file kind. This request produces the same report that is produced by the FILENAMES request that includes the ARCHIVE modifier. Refer to the description of the 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.

<archiveinfo request> 

── ARCHIVEINFO ────────────────────────────────────────────────────────►
►─┬─────────────────────────────────────────────────────┬──────────────┤
  └─ : ─┬───────────────────────────────────────────────┤
        │ ┌◄──────────────────────────────────────────┐ │
        └─┴─┬─ BACKUPSN ── = ──<tape serial number>─┬─┴─┘
            ├─ CATALOGUE ───────────────────────────┤
            ├─ DATABASE ────┬─ = ──<file title>─────┤
            ├─ GUARDFILE ───┤                       │
            ├─ DIRECTORY ───┤                       │
            ├─ NEWDATABASE ─┤                       │
            ├─ TITLE ───────┘                       │
            ├─ ARCHIVEBACKUP ── = ─┬─ ANY ──────────┤
            │                      ├─ CURRENT ──────┤
            │                      ├─ NONCURRENT ───┤
            │                      └─ NONE ─────────┤
            ├─<CODEVERSION modifier>────────────────┤
            ├─ 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 ARCHIVEINFO, then precede the ARCHIVEINFO request with a DEFINEOUTPUT request that sets LINEWIDTH = 132. Otherwise, the record size defaults to 80 bytes, which is too short for an ARCHIVEINFO 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.

  • ARCHIVEBACKUP

  • BACKUPSN

  • CATALOGUE

  • CODEVERSION

  • DATABASE

  • DELETED

  • DIRECTORY

  • FAMILYNAME

  • GUARDFILE

  • LEVEL

  • NEWDATABASE

  • NONRESIDENTONLY

  • RAWHEADERS

  • REMOVED

  • RESIDENTONLY

  • TITLE

ARCHIVEINFO Examples

The following example produces a ARCHIVEINFO report on all the files specified in the database UTILITYDB. UTILITYDB is a database created by a previous FILEDATA run. 

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

The following statement produces a report of all files under the directory SYMBOL/X ON PACK that do not have any archive backups: 

RUN *SYSTEM/FILEDATA ("ARCHIVEINFO: ARCHIVEBACKUP=NONE
                       DIRECTORY = SYMBOL/X FAMILY = PACK");

The following statement, when run under a privileged usercode or started from an ODT, produces a report of all the files on the family WORKPACK that have backup copies on the tape with the serial number X12. 

RUN *SYSTEM/FILEDATA ("ARCHIVEINFO: BACKUPSN = X12 FAMILY = WORKPACK");

Note that the report includes both resident files and nonresident files that were removed with the WFL RELEASE statement. If tape X12 was originally produced by a WFL ARCHIVE BACKUP or ARCHIVE ROLLOUT statement for the family WORKPACK, then you could use this FILEDATA report to determine whether tape X12 is still needed.

Prev  Up  Next
ALGOLCHECK Request  Home  AREASUMMARY Request