FUP Commands
File Utility Program (FUP) Reference Manual—523323-014
2-39
COPY: Copy Form
KEY { record-spec | key-value }
specifies the primary-key value for the starting record of a disk file. FUP
begins reading the input file at the record you name with KEY.
Specify record-spec as an integer in the range 0 through 4,294,967,295.
For unstructured files, give the starting relative byte address for
record-spec.
For relative files, give the starting record number for record-spec.
For entry-sequenced files, give the record address for record-spec.
To indicate the approximate position of the starting record for key-
sequenced files, use key-value. Specify key-value as string or:
"[" { string } [ , string ] ... "]"
{ 0:255 } [ , 0:255 ]
You can specify a list of strings with each string enclosed by quotation
marks or integers representing byte values in the range 0 through 255. You
must enclose the list of strings and integers (if specified) in square
brackets.
For example, specify a key value as the ASCII string “T905”, followed by a
word containing the integer value zero, and a word containing the integer
value nine:
[ "T905", 0, 0, 0, 9 ]
KEY64 { record-spec }
specifies the 64-bit key value for the starting record of an entry-sequenced
file. FUP begins reading the input file at the record you name as KEY64.
key-specifier
is a one-character or two-character string (located inside quotation marks)
specifying the alternate key to use for positioning purposes.
ALTKEY key-value
specifies the alternate key of the starting record for a key-sequenced disk
file. FUP begins reading the input file at the specified record and obtains
subsequent rows in alternate key order. Specify key-value for key-
sequenced files as described in KEY { record-spec | key-value } on
page 2-39.
Note. The brackets in key-value syntax are enclosed in quotation marks to
indicate that they are part of the parameter—not to indicate that the parameter is
optional. Do not include the quotation marks when you type the brackets.