FCOPY Reference Manual (32212-90008)

Chapter 5 75
FCOPY Functions
FILES
FILES
Lets you copy multiple files from labeled and unlabeled magnetic tapes, serial disks, and
cartridge tapes. FCOPY copies only one file if you do not use the FILES function.
Syntax
;FILES={ number-of-files
ALL }
Where:
number-of-files Is an integer specifying the number of files to be copied.
ALL Specifies that all files from the current file to the end of the tape be copied.
Operation
Before determining which files to copy, FCOPY positions the tape at the beginning of the
current file. Figure 5-2 illustrates an example. Before you issue the FCOPY command with
FILES=2, the tape is positioned at the end of file 1. When you issue the FCOPY command,
FCOPY positions the tape at the beginning of file 1 and copies two files. In figure 5-2, the
shaded files represent the files copied:
Figure 5-2. Tape Position
If you use the FILES function together with the SUBSET function, FCOPY assumes that the
SUBSET function applies to every file to be copied. For example, the command below
produces the results illustrated in figure 5-3.
>FROM=*TAPEA;TO=*TAPEB;FILES=3;SUBSET=11:25