ADDED and ALLFILES Requests

The ADDED and ALLFILES requests cause FILECOPY to copy files created since a particular date or simply to copy all files encountered.

Syntax

<added request>

── ADDED ─┬─────────────────────┬─ SINCE ──<file title>────────────────►
          └─<filecopy modifier>─┘
►─┬─────────────────────┬──────────────────────────────────────────────┤
  └─<filecopy modifier>─┘

<allfiles request>

             ┌◄──────────────────────────────┐
── ALLFILES ─┴─┬───────────────────────────┬─┴─────────────────────────┤
               ├─/1\─ SINCE ──<file title>─┤
               └─<filecopy modifier>───────┘

Explanation

Components of the ADDED and ALLFILES Requests provides an explanation for the components of the syntax diagram.

Table 25. Components of the ADDED and ALLFILES Requests

Component

Explanation

ADDED SINCE <index file title>

Copies files whose creation date is less than the creation date of the index file specified by the file title and that are not listed in that index file. Refer to “Index Files” later in this section.

ALLFILES SINCE <index file title>

Copies all files that the program encounters except the files listed in the index file specified by the file title. The file title must refer to an index file. Refer to “Index Files” later in this section.

ALLFILES <filecopy modifier>

Copies all files encountered (subject to any exclusion lists or criteria specified in the modifiers).

<filecopy modifier>

Provides the following:

  • The names and kinds of disks from which files are to be copied

  • The names of the files and directions from which FILECOPY should select files for copying

  • The name and kind of the output disk, tape, or CD-ROM

  • Other control information.

The <filecopy modifier> must contain a FILES, INCLUDE, or EXCLUDE file specification.