File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-45
COPY: Copy Form
REELS num-reels
indicates the use of multiple reels and sets the number of reels that make up
in-filename (for unlabeled magnetic tape only). You cannot specify this
option if in-filename is a tape DEFINE with LABELS set for labeled tape
processing. You must use the appropriate tape DEFINE attributes to process
multi-reel labeled tapes.
Specify num-reels as an integer ranging from 2 through 255. The tape is
read until num-reel occurrences. FUP always requests num-reels tapes
because it can recognize the end of a multiple reel (unlabeled) tape file only by
using the num-reels specification. At the end of each reel (except the last
one, depending on the REWINDIN and UNLOADIN parameters), the tape is
rewound and unloaded, and you are prompted for the next reel.
The FUP process expects two consecutive EOF marks, and it cannot
accommodate multireel unlabeled tapes that are written on IBM systems (or
any other systems) that do not adhere to the two consecutive EOF mark
format.
For FUP to distinguish between the end of an intermediate volume and the
EOF, the value of num-reels must be correct.
If you include the REELS option in the COPY command and in-filename is
a tape DEFINE, FUP displays this error message:
ERROR - REELS PARAMETER NOT ALLOWED
FOR LABELED TAPES
If you omit REELS, in-filename data transfer terminates when FUP
encounters a single EOF mark.
Labeled-tape handling for multiple reels follows IBM or ANSI standards, which
do not have the limitations imposed by FUP.
[ NO ] REWINDIN
specifies that the tape is rewound (or not rewound) when the EOF is read from
the tape (for magnetic tape only). If you specify NO REWINDIN, the tape
remains positioned without rewinding. The default is REWINDIN. (The tape is
rewound.) This option also applies to labeled tapes.
SHARE
opens in-filename with a shared exclusion mode (for disk files only). Using
SHARE lets you copy a file even if it is currently opened by another process
(unless it is open with exclusive exclusion mode). If you omit SHARE (and
in-filename is a disk file), the file is opened with protected exclusion mode.
Note. For D-series and G-series RVUs, see the Guardian User’s Guide for more
information. This parameter does not apply to H-series RVUs because reel-to-reel
tapes are not supported.