File Utility Program (FUP) Management Programming Manual

FUP Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
2-19
Handling FUP Errors
Figure 2-9. Error List for a FUP Error
Other Subsystem and Software Component Errors
When FUP executes a command, these subsystems and software components are
sometimes called to perform various tasks:
•
EDITREAD and EDITREADINIT file-system procedures
•
FASTSORT utility
•
NonStop Kernel
•
Guardian file system
Errors can originate from these subsystems or software components. When this type of
error occurs, ZSPI-TKN-RETCODE indicates that the attempted command failed with
an error from a source other than FUP. The FUP error list contains the token ZSPI-
TKN-ERROR, the token map ZFUP-MAP-CMD-ERROR, and another nested error list
describing the actual error. The nested error list indicates where the error occurred.
If a LOAD command failed because of a file-system error on a WRITE procedure call,
ZSPI-TKN-RETCODE has the value ZFUP-ERR-FILESYS (17) to indicate this error.
Figure 2-10 on page 2-20 shows an example of this nested error list.
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERROR
Z-SSID ! FUP subsystem ID
Z-ERROR ! ZFUP-ERR-EMPTY-SOURCE (35)
ZFUP-MAP-CMD-ERROR
ZCOMMAND ! LOAD command
ZOBJECT ! Object type (file)
ZNAME ! Name of the empty source file
ZSPI-TKN-ENDLIST