Guardian Procedure Errors and Messages Manual
Unconditional Tokens
ZSPI-TKN-ERROR is the standard SPI error token, whose value consists of the fields Z-SSID and
Z-ERROR. Z-SSID is the subsystem identifier ZFIL-VAL-SSID. Z-ERROR is the file-system error code
returned in the error parameter of FILEINFO.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is ZFIL-VAL-KEYPOSITION
(10).
ZFIL-TKN-XFILENAME is the completely qualified file name (including node name) in external format.
The token ZFIL-TKN-XFILENAME can be null if certain errors occur. For example, if file-system error
16 (file not opened) occurs, the token will be null.
Conditional Tokens
ZFIL-TKN-COMPAREKEYLENGTH is the key length (<8:15>) and the compare length (<0:7>).
ZFIL-TKN-FILENAME is the name of the file in internal network format. If the file name cannot be
represented in this format or if the file name is not known (file-system error 16 occurred), this token
will not appear.
ZFIL-TKN-KEYVALUE is the key value.
ZFIL-TKN-KEYSPEC is the key specifier.
ZFIL-TKN-POSITIONMODE is the positioning mode.
Effect
The attempted KEYPOSITION operation fails.
Recovery
Follow the recovery procedure for the returned file-system error code as described earlier in this
section.
11: ZFIL-VAL-OPEN
A call to the OPEN procedure resulted in a condition code less (CCL) or a condition code greater
(CCG). If CCL (ZFIL-TKN-CONDITION=-1), the file is not opened. If CCG (ZFIL-TKN-CONDITION=1),
the file is open, but the file system detected an exceptional condition during the OPEN operation.
Unconditional Tokens
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.
ZSPI-TKN-ERROR token-type ZSPI-TYP-ERROR.
ZSPI-TKN-PROC-ERR token-type ZSPI-TYP-ENUM.
ZFIL-TKN-FILENAME token-type ZSPI-TYP-FNAME.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
Conditional Tokens
ZFIL-TKN-CONDITION token-type ZSPI-TYP-INT.
ZFIL-TKN-PRIMARYFILE token-type ZSPI-TYP-INT.
ZFIL-TKN-PRIMARYPROCESS token-type ZSPI-TYP-CRTPID.
ZFIL-TKN-BLOCKBUFFERLENGTH token-type ZSPI-TYP-UINT.
Unconditional Tokens
ZSPI-TKN-ERROR is the standard SPI error token, whose value consists of the fields Z-SSID and
Z-ERROR. Z-SSID is the subsystem identifier ZFIL-VAL-SSID. Z-ERROR is the file-system error code
returned in the error parameter of FILEINFO.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is ZFIL-VAL-OPEN (11).
ZFIL-TKN-FILENAME is the file name (blank-filled if unknown).
98 File-System Errors