FILECOPY receives its instructions through a file called INPUT. The records of this file must be randomly accessible. FILECOPY correctly handles input from a 15-word-record-size disk file with a FILEKIND value of JOBSYMBOL.
Syntax
<input to filecopy>
┌◄─────────────────────── ; ───────────────────────┐ ──┴─/5\─<filecopy task request>──<filecopy modifier>─┴─────────────────┤
Input
You can enter a maximum of five separate sets of instructions separated by semicolons, to produce WFL jobs that FILECOPY starts. Each set includes the following two components:
-
A FILECOPY task request that specifies the method by which individual files are to be included in the copy output.
-
A FILECOPY modifier to provide 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 task requests and modifiers are explained later in this section.
The FILECOPY modifier permits three forms of file selection or exclusion. These forms allow you to specify several files or directories from a single family.
-
A FILES list that specifies files that FILECOPY is to check against the specified criteria (EXPIRED, CREATED, and so forth).
-
An INCLUDE list that permits files to be included that do not match the criteria.
-
An EXCLUDE list that permits files to be excluded that do meet the criteria.
You can specify additional file selection criteria with index files. An index file contains a complete list of all files that meet the testing criteria of the task or are included in the task. The format of the index file is shown under “Index Files” later in this section. FILECOPY creates an index file when you specify the LOCKINDEX option. When you use the ADDED task request, FILECOPY requires that an index file be available for use.
Options
After you enter the desired FILECOPY task, you can place any options in any order on one or more records. Order is important only in cases in which some options override others.
Default specifications exist for each option except the FILECOPY task requests. Unless you use the NOSUMMARY option, FILECOPY lists default specifications, along with requested options and results at the end of a run.
Errors
FILECOPY checks all input for syntax errors, and if it detects any input errors, the entire run terminates. In other words, if syntax errors exist in any task request, modifier, or options, FILECOPY does not execute any of the task requests.
If FILECOPY finds errors during the creation of copy lists, it attempts to recover from the errors. If these recovery attempts fail, processing terminates for those requests that have been flagged with error messages, but other requests proceed unaffected.
FILECOPY prints the following output:
-
A list showing each line of the input. If any line contains syntax errors, the program flags them with a message placed immediately below the offending line.
-
Other errors that FILECOPY detects only after it has processed the entire input appear after all input has been printed.
-
For ease of reference, the invalid task request is printed along with the associated error message.
| Note: | If a FILEKIND mnemonic is pending deimplementation, FILECOPY prints a warning if the mnemonic is used in an INCLUDE FILEKIND or EXCLUDE FILEKIND option. However, FILECOPY still executes the task requests. |
