Guardian Procedure Errors and Messages Manual
Recovery
Follow the recovery procedure for the returned file-system error code as described earlier in this
section.
67: ZFIL-VAL-FILE-OPEN
A call to FILE_OPEN_ returned a nonzero error as the function value.
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-XFILENAME token-type ZSPI-TYP-STRING.
ZFIL-TKN-STATUS token-type ZSPI-TYP-INT.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
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 error code returned in
the error parameter of FILE_OPEN_.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is ZFIL-VAL-FILE-OPEN
(67).
ZFIL-TKN-XFILENAME is the file name.
ZFIL-TKN-STATUS qualifies the source of the error.
Effect
Status is the file number returned by FILE_OPEN_. If an error occurred and ZFIL-TKN-STATUS is -1,
the open failed. If ZFIL-TKN-STATUS is not -1, the file was opened with a warning.
Recovery
Follow the recovery procedure for the returned file-system error code as described earlier in this
section.
68: ZFIL-VAL-FILE-PURGE
A call to FILE_CLOSE_ returned a nonzero error as the function value.
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-XFILENAME token-type ZSPI-TYP-STRING.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
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 error code returned in
the error parameter of FILE_CLOSE_.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is ZFIL-VAL-FILE-CLOSE
(69).
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.
Error Lists 123