Guardian Procedure Errors and Messages Manual

Error Lists

If you are using the Subsystem Programmatic Interface (SPI) to send commands to a subsystem,

you might receive a file-system error list in a response. HP subsystems return such an error list when,

in performing your request, they call a file-system procedure directly or indirectly and an error

occurs on the call.

The contents of the error list depend on which procedure was called. The standard SPI token

ZSPI-TKN-PROC-ERR, which is present in every file-system error list, identifies the procedure.

Each error list always includes the unconditional tokens listed under its description in this subsection.

In addition, each error list can include any of the conditional tokens listed under its description

and in Table 5.

If you are designing a subsystem that uses SPI, follow these guidelines when constructing a file-system

error list:

• Include all unconditional tokens listed in the error-list description.

• Make the ZFIL-TKN-XFILENAME token value null if you cannot obtain a valid file name, such

as when these errors occur:

◦ File-system error 16 (file not opened). This error indicates a coding error.

◦ File-system error 26 (no outstanding I/O requests) when it is returned by an AWAITIO

call in which file-number is equal to -1.

◦ File-system error 40 (operation timed out) when it is returned by an AWAITIO call in

which file-number is equal to -1.

• Optionally include any or none of the conditional tokens listed in Table 5. Note that the tokens

listed might not be appropriate for every file-system error. To obtain values for the tokens, use

FILE_GETINFOLIST_ or FILEINFO and pass the procedure a valid file number, or use

FILE_GETINFOLISTBYNAME_ or FILEINFO and pass the procedure a valid file name.

This subsection does not discuss the mechanics of error-list construction. For information about

creating error lists, and for additional information about tokens and token types, and for definitions

of tokens whose names begin with ZSPI-, see the SPI Programming Manual.

Table 5 Conditional Tokens That Can Appear in Any File-System Error List

DescriptionToken TypeToken Name

is the alternate key parameters.ZSPI-TYP-BYTESTRINGZFIL-TKN-ALTKEYPARAMS

is the data block length.ZSPI-TYP-UINTZFIL-TKN-BLOCKLENGTH

is the current key length.ZSPI-TYP-INTZFIL-TKN-

CURRENTKEYLENGTH

is the current key specifier.ZSPI-TYP-INTZFIL-TKN- CURRENTKEYSPEC

is the current key value.ZSPI-TYP-BYTESTRINGZFIL-TKN-

CURRENTKEYVALUE

is the current primary key length.ZSPI-TYP-INTZFIL-TKN-

CURRENTPRIKEYLENGTH

is the current record pointer (relative byte address).ZSPI-TYP-INT2ZFIL-TKN-

CURRENTRECPOINTER

is the device type.ZSPI-TYP-INTZFIL-TKN-DEVTYPE

is the end-of-file location (relative byte address).ZSPI-TYP-INT2ZFIL-TKN-EOFPOINTER

is the error-detail parameter where applicable.ZFIL-TYP-INTZFIL-TKN-ERRORDETAIL

88 File-System Errors