Basic FILEDATA Constructs

The following items commonly appear as syntactic variables in the syntax diagrams featured in this section. The variables are presented in alphabetical order (ignoring nonalphabetic characters).

<alphanumeric character>

Any of the characters A through Z or 0 through 9, inclusive.

<digit>

Any one of the decimal digits 0 through 9, inclusive.

<EBCDIC string character>

Any one of the displayed EBCDIC characters except the double quotation mark (").

<family name> 

  ┌◄──────────────────────────────┐
──┴─/17\─<alphanumeric character>─┴────────────────────────────────────┤

Identifies a disk family. The actual disk family reported on can be affected by family substitution, as discussed under “Effects of Family Substitution” later in this section.

Note: On cataloging systems, the family name TAPE refers to cataloged tape files.

<file name> 

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

<file title> 

──<file name>─┬─────────────────────┬──────────────────────────────────┤
              └─ ON ──<family name>─┘

<hex digit>

Any one of the hexadecimal digits 0 through 9 or A through F. Hexadecimal digits can be used to create strings.

<hex string> 

  ┌◄────────────┐
──┴─<hex digit>─┴──────────────────────────────────────────────────────┤

<identifier> 

    ┌◄─/17\────────────────────┐
──┬─┴─<alphanumeric character>─┴──────────────┬────────────────────────┤
  │      ┌◄─/17\───────────────────────┐      │
  └─ "" ─┴─<nonquote EBCDIC character>─┴─ "" ─┘

When non-alphanumeric characters are included in an identifier, the identifier must be enclosed in two sets of quotation marks. The quotation marks must be doubled because they are embedded within a longer string (the parameter list).

<integer> 

  ┌◄─────────────┐
──┴─/11\─<digit>─┴─────────────────────────────────────────────────────┤

<nonquote EBCDIC character>

Any EBCDIC character for which the hexadecimal code is greater than or equal to hexadecimal 40 and which is not the quotation mark (").

<relation> 

──┬─ > ───┬────────────────────────────────────────────────────────────┤
  ├─ < ───┤
  ├─ = ───┤
  ├─ GTR ─┤
  ├─ LSS ─┤
  ├─ EQL ─┤
  ├─ LEQ ─┤
  └─ GEQ ─┘

The GTR and > operators both mean greater than. The LSS and < operators both mean less than. The EQL and = operators both mean equal to. The GEQ operator means greater than or equal to, and the LEQ operator means less than or equal to.

<release level>

The <release level> specification is in SSR format:

────<digit>──<digit>── . ───<digit>─────────────────────────────────────┤

<tape name> 

────<identifier>────────────────────────────────────────────────────────┤

When an all-numeric tape name is used, the identifier must be surrounded by quotation marks to distinguish it from a unit number.

<tape serial number> 

  ┌◄─────────────────────────────┐
──┴─/6\─<alphanumeric character>─┴─────────────────────────────────────┤

<unit number> 

──<integer>────────────────────────────────────────────────────────────┤

<usercode> 

  ┌◄──────────────────────────────┐
──┴─/17\─<alphanumeric character>─┴────────────────────────────────────┤

<volume name> 

  ┌◄──────────────────────────────┐
──┴─/17\─<alphanumeric character>─┴────────────────────────────────────┤

The name of a tape or CD-ROM optical disk.

Notes:

  • The name of a tape can have two nodes. The second node, however, must be ‘‘FILE000'' as this node represents the name of the directory file. For example, a tape can be named MYTAPE/FILE000.

  • For the DIRECTORY and TITLE modifiers, the <file title> construct can be a <usercode>. In this case, FILEDATA reports on all the files under the specified usercode.

  • For the DIRECTORY and TITLE modifiers, an equal sign (=) or an asterisk and an equal sign (*=) are valid syntax.

  • Underscore characters are permitted in CD-ROM names.

Prev  Up  Next
TDIR (Tape Directory) Command  Home  GUARDFILE Utility