The following items commonly appear as syntactic variables in the syntax diagrams featured in this section.

Syntax

<name>

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

Explanation

<alphanumeric character>

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

<EBCDIC string character>

Any one of the 256 EBCDIC characters (including wild-card characters) except a single double quotation mark ("). Double quotation marks must be used in pairs.

Syntax

<file name>

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

<long file name>

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

<node name>

──┬─<letter>─┬─┬────────────────────────────────────┬──────────────────┤
  ├─<digit>──┘ │ ┌◄────────────────────────┐        │
  │            └─┴─ /16\ ─┬─<letter>─────┬─┴────────┤
  │                       ├─<digit>──────┤          │
  │                       ├─<hyphen>─────┤          │ 
  │                       └─<underscore>─┘          │
  │     ┌◄────────────────────────────────────┐     │
  └─ " ─┴─ /17\ ──<nonquote EBCDIC character>─┴─ " ─┘

<long node name>

──┬─<letter>─┬─┬─────────────────────────────────────┬─────────────────┤
  ├─<digit>──┘ │ ┌◄─────────────────────────┐        │
  │            └─┴─ /214\ ─┬─<letter>─────┬─┴────────┤  
  │                        ├─<digit>──────┤          │ 
  │                        ├─<hyphen>─────┤          │ 
  │                        └─<underscore>─┘          │ 
  │     ┌◄─────────────────────────────────────┐     │ 
  └─ " ─┴─ /215\ ──<nonquote EBCDIC character>─┴─ " ─┘

<directory name>

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

<long directory name>

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

Explanation

<file name>

You can use the following wild-card characters in FILECOPY file names. Refer to the MCP System Interfaces Programming Reference Manual for more information about and examples of wild-card characters.

<long file name>

Long file names can be used only if the system option LONGFILENAMES is set.

<usercode>

A name that specifies the usercode of the file. The quoted form of the name cannot be used for the usercode.

<letter>

Any one of the 26 uppercase characters A through Z.

<digit>

Any one of the 10 Arabic numerals 0 through 9.

<hyphen>

The single character hyphen (-).

<underscore>

The single character underscore (_).

<nonquote EBCDIC character>

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

Syntax

<file title>

── <file name> ── ON ── <family name> ─────────────────────────────────┤

<long file title>

── <long file name> ── ON ── <family name> ────────────────────────────┤

Explanation

ON <family name>

Specifies a disk family. The default family is DISK.

<family name>

Identifies a disk family. You cannot use the quoted form of the name as a family name.

Syntax

<timestamp>

──┬─<date>─┬─────────────────┬─────────────────────────────────────────┤
  │        └─ @ ──<integer>──┤
  ├─ @ ──<integer>───────────┤
  └─ TODAY ─┬────────────────┤
            └─ ─ ──<integer>─┘

<date>

── <month> ── / ── <day> ── / ── <year> ───────────────────────────────┤

Explanation

<month>

Two digits representing a month of the year.

<day>

Two digits representing a day of the year.

<year>

Either two or four digits representing the year; for example, either “99” or “1999”. If you use the two-digit format, the system acts as shown in Two-Digit Years in the FILECOPY Timestamp.

<date> @ <integer>

Specifies the day and time of day. If you do not specify a <date>, the @ <integer> syntax is required. When no <date> is specified, FILECOPY uses today's date. The construct “@ <integer>” selects a time. The form of the time is “hhmm” where “hh” is a value from 0 to 23 and “mm” is a value from 0 to 59.

For example, if you specify “@ 15” that represents “00:15”, or 15 minutes after midnight; or if you specify “@ 1500” that represents “15:00” or three o' clock in the afternoon. If you do not specify @ <integer>, FILECOPY uses a value of zero (0).

TODAY

Indicates that the timestamp to be used is the date on which you execute FILECOPY.

TODAY –<integer>

Indicates that the timestamp refers to <integer> days before the TODAY value.