File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-18
DUPLICATE Command
ZSPI-TKN-ERRLIST
is the standard SPI token that begins an error list. The error list ends with ZSPI-
TKN-ENDLIST.
ZSPI-TKN-CONTEXT
is the standard SPI token that indicates whether FUP has more reply messages to
return:
•
If ZSPI-TKN-CONTEXT is present in the response buffer, FUP has more reply
messages to return. Return the token in the command buffer to FUP. You can
ignore the actual value of ZSPI-TKN-CONTEXT because this value is
important only to FUP.
•
If ZSPI-TKN-CONTEXT is not present in the response buffer, FUP has
returned all of the reply messages.
Considerations
•
When duplicating a file set, you must specify the file name part of ZFUP-TKN-
DEST-FILE as an asterisk (*). Each output file is given the same file name as its
corresponding input file.
•
If you specify the subvolume name part of ZFUP-TKN-DEST-FILE as an asterisk,
each output file is given the same subvolume name as its corresponding input file.
These considerations apply only to a DUPLICATE command with the restartable option
selected:
•
The restartable option is useful when you duplicate large files. If the duplicate
operation fails before it completes, FUP can continue the operation from the point
of failure—thus saving system time and resources.
•
If a restart file is specified on an optical disk volume, or if the default subvolume of
the application is on an optical disk volume (and ZFUP-TKN-RESTART-FILE
contains all blanks), FUP returns the error ZFUP-ERR-OPTICAL-RESTART-FILE.
85 ALT-FILE-MISSING An alternate key does not have an
alternate-key file.
100 REST-TOO-MANY-FILES More than one source file is specified, and
the restartable option is selected.
101 OPTICAL-RESTART-FILE The restart file is located on an optical disk
volume.
Note. Fpr more information about all FUP error numbers and their corresponding error
lists, see Appendix B, FUP Error Messages.
Table 3-2. Errors Returned by DUPLICATE (page2of2)
Error
Number
Symbolic Name
(ZFUP-ERR-) Description