HP 3000 Manuals

FCOPY Reference Manual

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 


          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 

MPE/iX 5.0 Documentation