File Utility Program (FUP) Management Programming Manual

ORSERV Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
4-17
Handling ORSERV Errors
Other Subsystem and Software Component Errors
The NonStop Kernel and the Guardian file system are sometimes called to perform
various tasks when ORSERV executes a command.
Errors can originate from these subsystems or software components. When this type of
error occurs, ZSPI-TKN-RETCODE indicates that the command failed with an error
from a source other than ORSERV. The ORSERV error list contains the token
ZSPI-TKN-ERROR, the token map ZORS-MAP-CMD-ERROR, and a nested error list
describing the actual error.
If the ONLINERELOAD command failed because of a file-system error on an open
procedure call, the ZSPI-TKN-RETCODE token has the value ZORS-ERR-FILESYS
(error 13).
The TAL example in Figure 4-9 on page 4-18 demonstrates how a sequence of
SSGET calls can extract the tokens from a nested error list—although the error checks
and error-handling routines are omitted from the example.
Figure 4-7. Error List for an ORSERV Command Failure
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
Z-SSID ! ORSERV subsystem ID
Z-ERROR ! ZORS-ERR-ORELOAD-INPROGRESS (15)
ZORS-MAP-CMD-ERROR
ZCOMMAND ! ZORS-CMD-ONLINERELOAD command
ZOBJECT ! Object type (ZORS-OBJ-FILE)
ZNAME ! Name of the target file
ZSPI-TKN-ENDLIST
Figure 4-8. Example of an ORSERV Nested Error List
ZSPI-TKN-ERRLIST ! Start of ORSERV error list
ZSPI-TKN-ERROR
Z-SSID ! ORSERV subsystem ID
Z-ERROR ! ZORS-ERR-FILESYS (13)
ZORS-MAP-CMD-ERROR
ZCOMMAND ! ZORS-CMD-ONLINERELOAD command (1)
ZOBJECT ! ZORS-OBJ-FILE object type (1)
ZNAME ! File that ORSERV was processing
ZSPI-TKN-ERRLIST ! Start of file-system error list
ZSPI-TKN-ERROR
Z-SSID ! File-system subsystem ID
Z-ERROR ! File-system error number
ZSPI-TKN-PROC-ERR ! Open procedure call
ZSPI-TKN-ENDLIST ! End of file-system error list
ZSPI-TKN-ENDLIST ! End of ORSERV error list