FILES

Syntax

   ;FILES={number-of-files

           ALL            }

Where:

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

Figure 5-3 Copying Subsets of Files to Tape

If you use the FILES function together with the SKIPEOF function, FCOPY positions the tape as specified with SKIPEOF first.

If the fromfile is an unlabeled tape, there is no standard that defines the mark used at the end of the last file on the tape. If you copy such a tape with FILES=ALL, the copy proceeds until an error occurs from trying to read unrecorded media.

On a labeled tape, two consecutive tapemarks following the trailer labels denote the end of the recorded media. In this case, the copy process ends when the consecutive tapemarks are encountered.

Copying Files on Labeled Tape

Unless you want to copy the same labeled tape file repeatedly, use NEXT as the sequence option for the LABEL parameter in the fromfile tape's file equation. For example, the commands below copy subsets of three files from labeled tape TAPEALFA to TAPEBETA, as shown in figure 5-4.

   >:FILE TAPEALFA;LABEL=,,,NEXT

   >:FILE TAPEBETA;LABEL=,,,NEXT

   >FROM=*TAPEALFA;TO=*TAPEBETA;FILES=3;SUBSET=11:25

Figure 5-4 Copying Subsets of Files to Labeled Tape

If you specify a particular file as the sequence option for the labeled tape, FCOPY copies data from that file to all the new files. For example, the commands below produce the result shown in figure 5-5:

   >:FILE TAPEALFA;LABEL=,,,4

   >FROM=*TAPEALFA;TO=TAPEBETA;FILES=3;SUBSET=11:25

Figure 5-5 Copying from a Single Labeled Tape File

For more information on the sequence options of the FILE command, refer to the FILE command in the MPE V/E Commands Reference Manual (32033-90006) or the MPE XL Commands Reference Manual (32650-90003). Refer to chapter 3 for examples of using FCOPY with labeled tapes.

Examples

In the example below, FCOPY copies four files, starting with the first file, from magnetic tape *TM1 to magnetic tape *TM7:

   >FROM=*TM1;TO=*TM7;FILES=4

The second example combines the SKIPEOF and FILES functions. FCOPY positions the unlabeled tape file *TM5 at its third file, positions the unlabeled tape file *TM2 four files forward from its current position, and then copies two files (files three and four) from *TM5 to *TM2:

   >FROM=*TM5;TO=*TM2;SKIPEOF=3,+4;FILES=2

In the final example, FCOPY copies all of the files on *ME to the files of *YOU:

   >FROM=*ME;TO=*YOU;FILES=ALL