File Utility Program (FUP) Management Programming Manual

File Utility Program (FUP) Management Programming Manual—523322-001
C-1
C ORSERV Error Messages
The ORSERV process returns an error list in the response buffer when an error is
detected in the command syntax or during execution of a command. The error lists are
organized by error number (ZORS-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 ORSERV process sets the return token ZSPI-TKN-RETCODE by the error number
to identify the error list. If a command completes without an error, ORSERV sets
ZSPI-TKN-RETCODE to ZORS-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
ORSERV from executing a command 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 ORSERV errors, see Section 4, ORSERV Programmatic
Interface.