File Utility Program (FUP) Management Programming Manual

FUP Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
2-21
Handling FUP Errors
Figure 2-11. FASTSORT/NonStop Kernel Nested Error List
To extract tokens from the nested error lists, use SSGET calls or loop over the buffer
and get all of the sequential tokens using ZSPI^TKN^NEXTTOKEN, then use a CASE
statement to process the expected tokens. Figure 2-12 on page 2-22 shows how to
navigate a nested error list.
ZSPI-TKN-ERRLIST ! Start of FUP error list
ZSPI-TKN-ERROR
Z-SSID ! FUP subsystem ID
Z-ERROR ! ZFUP-ERR-SORT (16)
ZFUP-MAP-CMD-ERROR
ZCOMMAND ! LOAD command
ZOBJECT ! Object type (file)
ZNAME ! Name of the file that FUP was
! unable to load
ZSPI-TKN-ERRLIST ! Start of FASTSORT error list
ZSPI-TKN-ERROR
Z-SSID ! FASTSORT utility ID
Z-ERROR ! FASTSORT error (64)
ZSPI-TKN-ERRLIST ! Start Compaq NonStop error list
ZSPI-TKN-ERROR
Z-SSID ! Compaq NonStop OS SSID
Z-ERROR ! File-system error 43
ZSPI-TKN-PROC-ERR ! Segment allocation procedure
ZSPI-TKN-ENDLIST ! End of Compaq NonStop error list
ZSPI-TKN-ENDLIST ! End of FASTSORT error list
ZSPI-TKN-ENDLIST ! End of FUP error list
Note. Figure 2-12 does not show error checking.