File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-51
COPY: Copy Form
If you include the SKIPOUT option (and out-filename is a tape DEFINE),
FUP displays this error message:
ERROR - SKIPOUT PARAMETER NOT ALLOWED FOR
LABELED TAPES
Specify num-eofs as an integer ranging from –255 through 255.

If you specify a positive value, the tape is forwarded past num-eofs EOF
marks and positioned immediately after the last EOF mark passed.

If you specify a negative value, the tape is rewound over num-eofs EOF
marks (-1 multiplied by num-eofs) and then moved forward and
positioned immediately ahead of the last EOF mark passed.

If you specify a value of zero, the SKIPOUT option is ignored.

If you omit the SKIPOUT option, the tape remains at its current position,
and the data transfer begins with the next physical record on tape.
TAPEMODE mode
indicates the mode in which the tape is written (for streaming drives only). The
mode can be either STARTSTOP or STREAM. If you do not specify
TAPEMODE, the default STARTSTOP mode is used for the tape operation.
STARTSTOP
selects the start-stop mode for the tape operation. STARTSTOP is the
default.
STREAM
selects the streaming mode for the tape COPY operation.
You must also specify the largest block size possible to receive the
maximum performance for streaming mode. For example, to use streaming
mode, specify BLOCKOUT 28,000.
[ NO ] UNLOADOUT
specifies whether the tape is unloaded after rewinding (for magnetic tape only).
The default is UNLOADOUT. (The tape is unloaded after it is rewound.) This
option also applies to labeled tapes.
VAROUT
writes variable-length, blocked records.
Each variable-length record is preceded by a one-word record-length indicator.
The record-length word contains the record length in bytes. Although records
can contain an odd number of bytes, the record-length word is always aligned
on a word boundary.