File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-15
DUPLICATE Command
ZSPI-TKN-MAXRESP
is the standard SPI token that indicates the maximum number of response records
that FUP returns in a response buffer. The values for ZSPI-TKN-MAXRESP are:
ZSPI-TKN-CONTEXT
is the standard SPI token that indicates if 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.
ZSPI-TKN-RESPONSE-TYPE
is the standard SPI token that indicates the type of response records that FUP
returns. The values for ZSPI-TKN-RESPONSE-TYPE are:
ZSPI-VAL-ERR-AND-WARN
FUP returns a response record only for a file that caused an error or a warning.
The response buffer contains at least one error list, regardless of the value of
ZSPI-TKN-RETCODE.
ZSPI-VAL-ERR-WARN-AND-NORM
FUP returns a response record for each file processed. This is the default.
ZSPI-TKN-ALLOW-TYPE
is the standard SPI token that determines whether FUP should continue
processing the remaining files in a file set if an error occurs on the current file in
the file set.
ZSPI-TKN-ALLOW-TYPE is significant only if ZSPI-TKN-MAXRESP is -1 (or
greater than 1). Otherwise, FUP ignores the token. The values for
ZSPI-TKN-ALLOW-TYPE are:
0 FUP returns one response record per buffer (not enclosed in a data list). This is the
default.
-1 FUP returns as many response records per buffer as the buffer can hold (with each
response record enclosed in a data list).
n FUP returns n response records per buffer (with each response record enclosed in
a data list). n must be a positive number.