File Utility Program (FUP) Management Programming Manual

File Utility Program (FUP) Management Programming Manual—523322-001
B-1
B FUP Error Messages
The FUP process returns an error list in the response buffer when it detects an error in
the command syntax or during execution of a command. The error lists are organized
by error number (ZFUP-ERR-value) in ascending order. Each error-list description
contains:
•
A header displaying the numeric and symbolic values for the error
•
A paragraph identifying the cause of the error
•
A box listing the simple and structured tokens that can appear in the error list
The notation used in the box for simple tokens is a shorthand version of the
essential information given in the DDL TOKEN-CODE statement.
Each error list begins with the ZSPI-TKN-ERRLIST token and ends with the
ZSPI-TKN-ENDLIST token.
Any nested error lists from other subsystems or software components (including
the FASTSORT utility) also begin and end with these tokens.
The remaining tokens are not in any particular order of occurrence.
•
A description of each token in the error list (excluding ZSPI-TKN-ERRLIST and
ZSPI-TKN-ENDLIST)
•
A recommended course of action to correct or alleviate the error
The FUP process sets the return token ZSPI-TKN-RETCODE by the error number to
identify the error list. If a command finishes without an error, FUP sets
ZSPI-TKN-RETCODE to ZFUP-ERR-OK (0).
Although ZSPI-TKN-RETCODE is zero, the response buffer can still contain an error
list. You need to investigate this warning. It signals a condition that does not prevent
FUP from executing commands but could cause other problems.
To determine the problem, enter the error list and check the value of the ZSPI-TKN-
ERROR token.
Note. For more information about FUP errors, see Section 2, FUP Programmatic Interface.