FUP Commands
File Utility Program (FUP) Reference Manual—523323-014
2-181
SET Parameters for Files With Alternate-Key Fields
ALTFILE ( key-file-number, filename )
adds or replaces the file name of an alternate-key file. You must include this
parameter for any undefined key file number that is referenced by an ALTKEY
specification. Specify key-file-number as an integer sequentially in the range 0
through 255 to designate the alternate-key file being named.
The FUP process expands a partial file name by adding the current default names
for node, volume, and subvolume.
If you add a new ALTFILE number, your SET command must also include an
ALTKEY option that specifies the alternate-key file.
If you are defining a new alternate-key file, you must create the file in a separate
operation either before or after using SET ALTFILE.
If you are deleting the last alternate-key specification, you must also delete the
corresponding alternate-file specification in the same SET command.
If you are deleting the last alternate-file specification, you must also delete the
corresponding alternate-key specification in the same SET command.
ALTKEY ( key-specifier { , altkey-param }... )
sets an alternate-key specification. You must specify each alternate key separately.
key-specifier
is a 2-byte value that identifies this alternate-key field. Specify
key-specifier as either a one-character or two-character string in quotation
marks:
"[c1]c2"
Or specify it as an integer from -32,768 through 32,767:
{ -32,768 : 32,767 }
You can use any characters for key-specifier except zero. If you omit c1,
then c1 is treated as a zero.
altkey-param
specifies attributes of the alternate-key file.
FILE key-file-number
sets the key-file number for key-specifier. Specify key-file-number
as an integer from 0 through 255. ALTFILE create-param relates this
number to an actual file. The default is zero.
Note. If you add a new key specifier that references an undefined key-file number,
you must include the ALTFILE option to define the alternate-key file.
To Next Page
Loading...
Need help?
General