Guardian Application Conversion Guide

Converting Distributed Systems Management (DSM) Applications
Converting Other Parts of an Application
096047 Tandem Computers Incorporated 8–33
Processing File-System Error Lists
Your DSM application might process file-system error lists from a subsystem. A
subsystem returns a file-system error list when a file-system error occurs during a
procedure call from the subsystem. The subsystem nests the file-system error list
within a subsystem error list.
For example, if you send a LOAD programmatic command to FUP, FUP in turn calls
the file-system WRITE procedure. If a file-system error occurs for the WRITE
procedure call, FUP returns a nested error list in the response buffer. The first error
list describes the LOAD command error and the second error list describes the WRITE
file-system error.
The D-series file-system error-list tokens are:
ZFIL-TKN-ERRORDETAIL (token-type ZSPI-TYP-STRING)
is a conditional token that a subsystem returns if an error condition contains more
information than the Z-ERROR integer field can hold.
ZFIL-TKN-XFILENAME (token-type ZSPI-TYP-STRING)
is a conditional token that a subsystem returns if the procedure specified a file-
name string parameter. It contains either a file name (including the node name) or
a null value if the system could not return a valid file name (for example, an
operation on an unopened file).
An error list can also contain a second ZFIL-TKN-XFILENAME token if a
procedure specifies a second file-name string parameter (for example, parameters
for the FILENAME_COMPARE_ procedure).
ZFIL-TKN-STATUS (token-type ZSPI-TYP-INT)
is a conditional token that a subsystem returns if it calls the FILE_OPEN_ or
FILE_OPEN_CHKPT_ procedure.
For FILE_OPEN_ , it is the value of the file-number parameter.
For FILE_OPEN_CHKPT_ , it is the value of the FILE_OPEN_CHKPT_ status
parameter, which can have these values:
0 The system opened the backup process successfully.
1 The system opened the backup process successfully,
but a warning occurred.
2 An error occurred when the system tried to open the backup process.
3 The system could not communicate with the backup process.
4 The system tried to open the backup process, but an error occurred for
the primary process.
The D-series file-system error lists are shown in Table 8-6. For additional information
about error lists and extracting tokens from them, refer to the Subsystem Programmatic
Interface (SPI) Programming Manual.