File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-50
COPY: Copy Form
If you specify the RECOUT option and out-filename is a tape DEFINE with
these attributes, you must not specify the RECLEN attribute of the DEFINE, or
RECLEN must match out-record-length:

LABELS set for labeled tape processing

USE set to OUT (or not specified)
If the RECLEN attribute is unspecified, it is set to out-record-length for
the life of the FUP command.
If you omit the RECOUT option, FUP determines the out-record-length
value:

If in-filename is a tape DEFINE that has RECLEN specified, USE is set
to OUT (or not specified), and LABELS is set for labeled tape processing,
out-record-length is set to the RECLEN value.

If you specify an out-block-length using the FUP BLOCKOUT option
or the BLOCKLEN attribute of a tape DEFINE (and it is less than or equal
to 4096), that value is used for out-record-length. If you specify an
out-block-length greater than 4096, the value of
out-record-length is 4096.

If you do not specify out-block-length and out-filename is an
unstructured disk file (or a process), out-record-length is 132.

If you do not specify out-block-length with the FUP BLOCKOUT
option or the BLOCKLEN attribute of a tape DEFINE (and out-filename
is a structured disk file or a nondisk device), FUP uses the record length
specified when the file was created—or at system generation.
[ NO ] REWINDOUT
specifies whether the tape is rewound when the COPY command finishes. If
you specify NO REWINDOUT, the tape remains positioned without rewinding.
The default is REWINDOUT. (The tape is rewound.) This option also applies to
labeled tapes.
SKIPOUT num-eofs
moves the tape past num-eofs end-of-file (EOF) marks before the data
transfer begins (for magnetic tape only). You cannot specify this option if
out-filename is a tape DEFINE with LABELS set for labeled tape
processing. You must use the appropriate tape DEFINE attribute to skip files
on a labeled tape.
Note. For more information, see the Guardian User’s Guide .