File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-13
DUPLICATE Command
ZSPI-VAL-FALSE
specifies that the destination file assumes the default security of the
executor of the DUPLICATE command. The default is ZSPI-VAL-FALSE.
ZDEST-OPTION
is an enumerated field that specifies the destination file options. The values
are:
ZFUP-VAL-NEW
FUP creates a new destination file with the same characteristics as the
source file. If a duplicate destination file already exists, FUP returns an
error. The default is ZFUP-VAL-NEW.
ZFUP-VAL-PURGE
specifies that if the destination file already exists, it is purged before FUP
duplicates the source file.
ZFUP-VAL-OLD
specifies that all of the destination files must already exist and must match
the characteristics of the corresponding source files. FUP then overwrites
each destination file.
ZFUP-VAL-KEEP
specifies that if a file matching the destination template already exists, the
corresponding file that matches the source template is not duplicated. FUP
duplicates only files that do not match the destination template.
ZFUP-MAP-PART-RENAME-OPTS
is an optional structured token that specifies options for renaming destination
partitions.
These options apply only when FUP creates the destination file (when
ZDEST-OPTION is either ZFUP-VAL-NEW or ZFUP-VAL-PURGE).
ZPART-NUMBER and ZPART-NAME are required fields, and both must be present
for each partition to be renamed. The fields are:
ZPART-NUMBER
specifies the partition file number that FUP should rename. The allowable
values are in the range 1 through 15. This field does not have a default value.
To rename the file, supply a value that is not null.