FILES

Selecting Files with Directory Name Nodes
Selecting Files with Wild-Card Characters
Selecting Files by Pattern Matching
Selecting Files by File Attributes

FILES Syntax 

── FILES ─┬──────────────────┬─────────────────────────────────────────►
          ├─<file name>──────┤
          ├─<file directory>─┤
          └─<directory name>─┘
►─┬─────────────────────────────────────────┬─┬────────────────┬───────►
  └─ ON ──<family name>─┬───────────────────┤ └─<file options>─┘
                        └─ ( ── CDROM ── ) ─┘
►─┬──────────────────────────┬─────────────────────────────────────────┤
  │     ┌◄─────────────────┐ │
  └─ : ─┴─<output options>─┴─┘

<file name>

                           ┌◄───── / ────┐
──┬──────────────────────┬─┴─/12\─<name>─┴─────────────────────────────┤
  ├─ ( ──<usercode>── ) ─┤
  └─ * ──────────────────┘

<file directory> 

──┬─ ( ──<usercode>── ) ───────────────────┬───────────────────────────┤
  │                        ┌◄───── / ────┐ │
  ├──────────────────────┬─┴─/11\─<name>─┴─┘
  ├─ ( ──<usercode>── ) ─┤
  └─ * ──────────────────┘

<directory name>

──┬─ ( ──<usercode>── ) ────────────────────────┬─ = ──────────────────┤
  │                        ┌◄─────────────────┐ │
  ├──────────────────────┬─┴─/11\─<name>── / ─┴─┘
  ├─ ( ──<usercode>── ) ─┤
  └─ * ──────────────────┘

<output options>

  ┌◄──────────── , ───────────┐
──┴─┬─ /1\ ─┬─ SINGLELINE ──┬─┴────────────────────────────────────────┤
    │       └─ LONGFORMAT ──┤
    ├─ /1\ ─┬─ RESIDENT ────┤
    │       ├─ NONRESIDENT ─┤
    │       └─ ALL ─────────┤
    └─ /1\ ──<depth>────────┘

Explanation

The FILES command lists the names and file types of files in your library. You can list unusercoded files (files that are prefixed with an asterisk (*) instead of a usercode), and with privileges, you can list files under other usercodes.

The FILES command cannot be used to specify a long file name. However, if the FILES command is used to list the contents of a directory that contains files with long file names, those long names are displayed. The LFILES command with the ABBREVIATED option can be used to specify a long file name when necessary.

Because there are several ways in which to search and list file names, the description, syntax diagrams, and examples for the FILES command are grouped according to the file selection method.

The following file selection methods are described in this section:

  • Selecting files with directory name nodes

    This method requires the complete name of a directory node (and succeeding nodes of a directory name if more than one node is specified) to list files under the specified directory.

  • Selecting files with wild-card characters

    Wild-card characters can be used to substitute nodes of a file name or characters within file name nodes. This method enables you to list file names when only part of a file name is known.

  • Selecting files by pattern matching

    This method enables you to list files by specifying within brackets a pattern of characters or a range of alphanumeric characters. File names that match the pattern are listed.

  • Selecting files by file attributes

    File names that meet the selection criteria specified by file attributes are listed.

ON <family name>

If ON <family name> is specified with the FILES command, family substitution does not apply. Search for file names on the specified family pack.

Refer to Selecting Files by File Attributes for the descriptions, syntax diagrams, and examples of the file options.

CDROM

If ON <family name> is followed by CDROM, the family name refers to a CD-ROM reader rather than a pack or disk. A CD-ROM reader is a read-only device that reads files stored on a compact disc.

FILES is valid for an ISO 9660 format CD. To list files on a library maintenance format CD, use the TDIR (Tape Directory) system command, or the FILEDATA TAPEDIR request.

For more information on the TDIR system command, refer to the System Commands Reference Manual.

For more information on the FILEDATA command, refer to the System Software Utilities Operations Reference Manual.

<output options>

The output options enable you to specify a format to display file names and file attributes. The following output options are available:

  • SINGLELINE

    The list of file names is displayed on the screen with each file name and file attributes listed on a line.

  • LONGFORMAT

    The list of file names is displayed on the screen with each file name and file attributes listed on multiple lines, if necessary.

  • RESIDENT

    The list of resident files is displayed. A resident file is the primary copy of the file that is stored on a disk, regardless of whether or not the disk is on-line. Backup copies of files stored on another disk family are not considered resident.

  • NONRESIDENT

    A list of nonresident files and directory names is displayed. A nonresident file is a file stored on a backup tape, or a backup copy of a file that is stored on a different disk family from that on which the primary copy of the file is stored.

  • ALL

    The ALL option lists both resident and nonresident files.

  • <depth>

    The depth option is used to specify the number of directory levels (subdirectories) of file names to be listed.

Prev  Up  Next
FAMILY  Home  Selecting Files with Directory Name Nodes