File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-32
LOAD Command
•
If you specify the ZPARTOF option when loading a nonpartitioned file, FUP returns
an error message. If the base partition specified with ZPARTOF does not exist, file-
system error #11 (file not in directory) is returned. If the base partition specified
with ZPARTOF is not a partitioned file (or is not a partition of the file being loaded),
FUP returns the ZFUP-ERR-BAD-PARTS error list.
•
To load a secondary partition, you must specify the name of the secondary partition
as ZFUP-TKN-DEST-FILE, and specify the name of the volume where the primary
partition resides for the ZPARTOF option.
•
To load only the primary partition, specify the name of the primary partition as
ZFUP-TKN-DEST-FILE, and specify the name of the primary volume for the
ZPARTOF option.
•
If the ZFUP-TKN-SOURCE-FILE records are sorted, disk space for the sort scratch
file and for ZFUP-TKN-DEST-FILE must exist concurrently during the sorting
phase.
•
Data that contains the ZPADCHAR or ZTRIMCHAR character can be altered or
lost. An example of this occurs if you pad each record in a data file with zeros to a
specific size in bytes and store the records in another file. If you then trim the
trailing zeros, any original data ending with zero is trimmed. To avoid this problem,
use a ZPADCHAR or ZTRIMCHAR character that is not part of your data.
•
The ZCOMPACT option affects only relative files. If you set ZCOMPACT to
ZSPI-VAL-TRUE to load data from a nonrelative file, FUP returns the warning error
list ZFUP-ERR-IGN-COMPACT.
•
If the input file is a relative file that contains zero-length (empty) records, and
ZCOMPACT is set to ZSPI-VAL-TRUE, FUP ignores the zero-length records. The
remaining records (other than the zero-length records) are compacted at the
beginning of the file. If you are loading relative files, always set ZCOMPACT to
ZSPI-VAL-FALSE.
•
When alternate-key records are not built because the full alternate key does not
exist within the primary record, FUP returns the ZFUP-ERR-SHORT-KEYS error
list.
Example
See the LOADALTFILE command Example on page 3-37.