File Utility Program (FUP) Management Programming Manual

ORSERV Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
4-16
Handling ORSERV Errors
•
Command failure errors encountered by ORSERV
•
Command failure errors encountered by a subsystem or software component other
than ORSERV
Syntax Errors in the Command Format
ORSERV first evaluates the command format in the buffer to determine if any syntax
errors exist. Examples are an invalid token value or an invalid command.
The ORSERV error list contains the ZSPI-TKN-ERROR token, which contains the error
number and the ORSERV subsystem ID, and the ZSPI-TKN-PARM-ERR token, which
identifies the token or field that caused the error. Because the command failed before
ORSERV started the reload operation, the error list does not contain a file-name token.
An example of an invalid token value error occurs if a field within a structured token is
not within its valid range. ZSPI-TKN-RETCODE has a value of ZORS-ERR-INV-VALUE
(7) to indicate this error.
ORSERV Errors
These errors occur when ORSERV tries to execute the command. For example, error
15 (ZORS-ERR-ORELOAD-INPROGRESS) occurs when ORSERV attempts an
ONLINERELOAD command for a target file that already has a reload operation in
progress.
The error list contains the token ZSPI-TKN-ERROR and a token map ZORS-MAP-
CMD-ERROR, which identifies the command that failed, the object type, and the file
that ORSERV was processing when the error occurred.
Figure 4-6. Error List for an Invalid Token Value
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
Z-SSID ! ORSERV subsystem ID
Z-ERROR ! ZORS-ERR-INV-VALUE (7)
ZSPI-TKN-PARM-ERR
Z-TOKENCODE ! Token code that caused the error
Z-INDEX ! Occurrence number of the token
Z-OFFSET ! Byte offset of the field
ZSPI-TKN-ENDLIST