File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-42
COPY: Copy Form
[ NO ] TITLE
directs FUP to write a title line that includes the name of the file, the time of the
COPY process, and the last modification time of the file. The title line is the first
line of the OUT file, followed by a blank line. These two lines become part of
the OUT file and are included in the RECORDS TRANSFERRED count. The
default is NO TITLE.
UNSTR[UCTURED]
causes an unstructured open on a file. You can use this option for any
unstructured disk file that is not in EDIT file format (or any Enscribe file
structure) and for any structured file where you want FUP to ignore its file
structure. This option is for disk files only.
You must use this option on partitioned files to copy partitions individually.
UPSHIFT
converts lowercase alphabetic characters to uppercase.
in-option
controls the handling of the copied input file. The in-option parameter is not
normally used with structured disk files.
BLOCKIN in-block-length
specifies the number of bytes in an input block. This number can be a value
ranging from 1 through 32,767 indicating the actual number of bytes requested
in a single physical read operation.
Input records are blocked if in-block-length exceeds
in-record-length. Records of the specified length are extracted from the
input block until the number of bytes extracted equals in-block-length or
until the last input record is read.
The read count for the records in a block (with the exception of the last record
in the block) is equal to in-record-length. If in-block-length is not an
exact multiple of in-record-length, the last record extracted from a full
block is a short record with a read count equal to the number of bytes
extracted.
If you specify BLOCKIN and in-filename is a tape DEFINE, do not specify
the BLOCKLEN attribute of the DEFINE. Otherwise BLOCKLEN must match
BLOCKIN in-block-length.
If the BLOCKLEN value is greater than 32,767 (the largest block size that FUP
can accommodate), FUP issues this error message and then aborts:
ERROR - TAPE DEFINE BLOCKLEN VALUE TOO LARGE