File Utility Program (FUP) Management Programming Manual

FUP Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
2-20
Handling FUP Errors
Figure 2-10. File-System Nested Error List
Errors from the FASTSORT utility are more complicated than file-system errors. The
FASTSORT utility can fail because of an error from another subsystem or software
component, causing nested error lists. The FUP error list contains the FASTSORT
error list, and the FASTSORT error list contains another error list that describes where
the error actually occurred.
If a LOAD command failed because the FASTSORT utility could not allocate an
extended segment after a NonStop Kernel procedure call, then ZSPI-TKN-RETCODE
has the value ZFUP-ERR-SORT (16) to indicate that the command failed with a
FASTSORT error. An example of this nested error list is displayed in Figure 2-11 on
page 2-21.
ZSPI-TKN-ERRLIST ! Start of FUP error list
ZSPI-TKN-ERROR
Z-SSID ! FUP subsystem ID
Z-ERROR ! ZFUP-ERR-FILESYS (17)
ZFUP-MAP-CMD-ERROR
ZCOMMAND ! LOAD command
ZOBJECT ! Object type (file)
ZNAME ! Name of the file that FUP was
! processing when the error occurred
ZSPI-TKN-ERRLIST ! Start of file-system error list
ZSPI-TKN-ERROR
Z-SSID ! File-system ID
Z-ERROR ! File-system error number
ZSPI-TKN-PROC-ERR ! WRITE procedure call
ZSPI-TKN-ENDLIST ! End of file-system error list
ZSPI-TKN-ENDLIST ! End of FUP error list