File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual523322-001
3-34
LOADALTFILE Command
Tokens in the Command Buffer
ZFUP-TKN-SOURCE-FILE
is a required token that specifies an existing primary file whose alternate-key
records are to be generated and loaded into the file indicated by the alternate-key
file number (ZFUP-TKN-ALTFILE-NUM token). The file name must be in the
Guardian internal file-name format. Only one of these tokens is allowed per
command.
ZFUP-TKN-ALTFILE-NUM
is a required token that specifies the alternate-key file number of the file that FUP
should load. The allowable values are in the range 0 through 255. Only one of
these tokens is allowed per command.
ZFUP-MAP-PAR-LOADALTFILE
is an optional structured token that specifies LOADALTFILE options. The fields are:
ZMAX-RECS
is an estimate of the number of records in the source file. FUP multiplies this
value by the number of alternate keys associated with the alternate-key file to
determine the size of the scratch file used by the FASTSORT process. The
allowable values are in the range 0 through 2,147,483,647. This value does
not have to be exact, but it should be greater than (or equal to) the number of
records in the source file. The default is 10,000.
ZSCRATCH
specifies a file name or volume name to be used for temporary storage during
the FASTSORT process. The name must be in Guardian internal file-name
format. The default is a scratch file on the default volume.
ZDSLACK
specifies the minimum percentage of slack space to be left in the data blocks of
the destination. Allowable values are in the range 0 through 99. The default is
0.
ZISLACK
specifies the minimum percentage of slack space to be left in the index blocks
of the destination. Allowable values are in the range 0 through 99. The default
is 0.
ZSPI-TKN-MAXRESP, ZSPI-TKN-RESPONSE-TYPE, ZSPI-TKN-ALLOW-TYPE
are standard SPI response-control tokens. If you set these tokens, they have no
effect on the execution of the command.