NAMELIST Request

The NAMELIST request produces a nonhierarchical list of file names.

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.

If you did not specify the LIBMAINTDIR option, or if the FILEDATA database used did not contain LIBMAINTDIR or TAPEHEADER information, then the number list in the report refers to the file number in the FILEDATA database.

<namelist request>

── NAMELIST ───────────────────────────────────────────────────────────►
►─┬─────────────────────────────────────────────────────────────┬──────┤
  └─ : ─┬───────────────────────────────────────────────────────┤
        │ ┌◄──────────────────────────────────────────────────┐ │
        └─┴─┬─ CONTAINER ─┬─ = <file title> ─┬──────────────┬─┴─┘
            ├─ DIRECTORY ─┘                  ├─ (CD) ───────┤
            │                                └─ (CDROM) ────┤
            ├─ DATABASE ────┬─ = ──<file title>─────────────┤
            ├─ NEWDATABASE ─┘                               │
            ├─ LIBMAINTDIR ── = ──<file title>──────────────┤
            ├─<output option>───────────────────────────────┤
            ├─ FAMILYNAME ─┬─ = ──<family name>─┬───────────┤
            ├─ PACKNAME ───┘                    ├─ (CD) ────┤
            │                                   └─ (CDROM) ─┤
            └─ TAPE ── = ─┬─<unit number>───────────────────┤
                          └─<tape name>─┬───────────────────┤
                                        ├─ ( ── CD ── ) ────┤
                                        └─ ( ── CDROM ── ) ─┘

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.

  • CONTAINER

  • DATABASE

  • DIRECTORY

  • FAMILYNAME

  • LIBMAINTDIR

  • PACKNAME

  • NEWDATABASE

  • TAPE

NAMELIST Example

The following command indicates a NAMELIST report on all files in the LIBMAINTDIR file LIBMAINTDIR/MYTAPE/20010417/XXXXXX. The report includes the name of each file. The output is sent to the printer by default.

RUN *SYSTEM/FILEDATA
 ("NAMELIST: LIBMAINTDIR=LIBMAINTDIR/MYTAPE/20010417/XXXXXX")