File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-16
DUPLICATE Command
ZSPI-VAL-NORM-ONLY
FUP processes the next file only if the command was successful for the current
file (that is, FUP did not return an error list for the file). This is the default.
ZSPI-VAL-WARN-AND-NORM
FUP processes the next file if the command completed for the current file. A
warning might have occurred for the file, but the ZSPI-TKN-RETCODE value is
zero.
ZSPI-VAL-ERR-WARN-AND-NORM
FUP processes the next file despite any problems encountered for the current
file.
ZSPI-TKN-COMMENT
is the standard SPI token that lets an application include an 80-byte arbitrary
comment in the command buffer. Although FUP ignores ZSPI-TKN-COMMENT in
the command buffer, the token can be useful when you are debugging an
application.
Tokens in the Response Buffer
ZSPI-TKN-DATALIST
is the standard SPI token that begins a data list. The data list ends with
ZSPI-TKN-ENDLIST.
ZFUP-TKN-FILE
is the name of the file on which the command was attempted. The file name is in
the Guardian internal file-name format. This token is returned with every response.
ZSPI-TKN-RETCODE
is the standard SPI return token that is returned in the response buffer by all
Compaq subsystems. If the command was successful, ZSPI-TKN-RETCODE
contains zero; if an error occurred, it contains an error number.
Table 3-2, Errors Returned by DUPLICATE shows the ZSPI-TKN-RETCODE values
specific to the DUPLICATE command.
Note. Table 2-7, Errors Returned by All FUP Commands, on page 2-28 shows the ZSPI-TKN-
RETCODE values common to all FUP commands.