File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-11
DUPLICATE Command
Tokens in the Command Buffer
ZFUP-TKN-SOURCE-FILE
is a required token that specifies the file or file set to duplicate. The file name must
be in the Guardian internal file-name format. Only one of these tokens is allowed
per command.
If the ZFUP-TKN-RESTART-FILE token is included in the buffer, ZFUP-
TKN-SOURCE-FILE must specify a single file.
ZFUP-TKN-DEST-FILE
is a required token that specifies the destination file or file set for the duplicate
operation. The file name must be in the Guardian internal file-name format. Only
one of these tokens is allowed per command.
ZFUP-TKN-RESTART-FILE
is an optional token that specifies the name of the restart file FUP creates to store
information for the RESTART command. This token also informs FUP that the
restartable option is selected. (This token is the only indication that the restartable
option is selected.)
You can set ZFUP-TKN-RESTART-FILE to:
•
A file name in the Guardian internal file-name format
•
Blanks, which make FUP create a default restart file named ZZRSTART in
your current subvolume
FUP creates the restart file (file code 855) after creating the destination file. If the
duplicate operation finishes successfully, FUP purges the restart file.
ZFUP-MAP-PAR-DUP
is an optional structured token that specifies options for the DUPLICATE
command. The fields are:
Tokens in the Response Buffer
ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST.
ZFUP-TKN-FILE token-type ZSPI-TYP-FNAME.
ZSPI-TKN-RETCODE token-type ZSPI-TYP-RETCODE.
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.
...
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
Note. For more information about assigning values to ZFUP-TKN-DEST-FILE during the
duplication of a file set, see Considerations on page 3-17.