Manualshelf

File Utility Program (FUP) Management Programming Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series
51525354555657585960
FUP Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
2-24
Common Definitions
Continuing After an Error
An error can occur on only one of the files in a file set for the commands that process
more than one file (CHECKSUM and DUPLICATE without the restartable option). If an
error does occur on a file, the SPI token ZSPI-TKN-ALLOW-TYPE determines if FUP
should continue processing the remaining files in the file set. The values for ZSPI-TKN-
ALLOW-TYPE are:
The value of ZSPI-TKN-ALLOW-TYPE is significant only if ZSPI-TKN-MAXRESP is -1
(or is greater than 1). Otherwise FUP ignores the token.
Common Definitions
The FUP programmatic commands use SPI standard definitions and FUP definitions.
This subsection provides a general description of these definitions. For specific
information about each definition, see Section 3, FUP Commands and Responses or
Appendix B, FUP Error Messages.
SPI Standard Definitions
SPI standard definitions begin with ZSPI- and are found in the ZSPITAL, ZSPICOB,
ZSPITACL, ZSPIPAS, and ZSPIC source definition files.
ZSPI-VAL-NORM-ONLY FUP processes the next file only if the command was
successful for the previous file. (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 previous file. A warning might have
occurred, 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 previous file.
Note. All definitions are shown in DDL (or COBOL85) format using hyphens (-) as separators.
If you are programming in TAL or TACL, substitute the circumflex (^) symbol for the hyphens. If
you are programming in C, substitute the underscore (_) symbol for the hyphens.
Note. For more information about these files, see Source Definition Files
on page 2-8.
Table 2-6. SPI Standard Definitions Used by FUP (page 1 of 2)
Header Tokens
ZSPI-TKN-CHECKSUM ZSPI-TKN-LASTPOSITION ZSPI-TKN-SERVER-VERSION
ZSPI-TKN-COMMAND ZSPI-TKN-MAX-FIELD-
VERSION
ZSPI-TKN-SSID
ZSPI-TKN-HDRTYPE ZSPI-TKN-MAXRESP ZSPI-TKN-USEDLEN
ZSPI-TKN-LASTERR ZSPI-TKN-OBJECT-TYPE