Negative error codes

FairCom DB negative error codes

Abstract

FairCom DB negative error codes

FairCom's Negative error codes are special because they indicate an operating system error in addition to the FairCom error. In the ISAM API, they set the variable sysiocod in conjunction with the variables isam_err or uerr_cod (depending on the API level that generated the error: ISAM functions set isam_err, and Low Level functions set uerr_cod ).

Table 1. Error Codes: -1 and lower

Value	Symbolic constant	Description
-8	FCNF_COD	Error -8 is a sysiocod value when FNOP_ERR (error 12) was caused by conflicting open requests (Server). ctdbAlterTable() can return this if you are doing a Hot Alter Table and the server can't get an exclusive lock on the file.
-9	FDEV_COD	Error -9 is a sysiocod value when FNOP_ERR (error 12), DCRAT_ERR (error 17), or KCRAT_ERR (error 16) were caused by device access error.
-539	BFIL_COD	Indicates sysiocod when file does not appear to contain any valid information.
-586	MFID_COD	Indicates a different file name, but a matching file ID was found.
-587	CPND_COD	Indicates close/delete deferred: pending transaction.
-594	XUSR_COD	Indicates users in SEC_BLOCK class logged on.
-632	LLOK_COD	Indicates user lost locks found on close.
-644	RDEL_COD	Indicates reversible TRANDEP delete.
-647	E2GB_COD	Indicates no support beyond 2 GB.
-648	E4GB_COD	Indicates no support beyond 4 GB.
-726	PPRG_COD	Indicates duplicate error caused by purged part.
-795	VTSM_COD	Indicates recursive ctptsema() call for open or create.
-823	TRAB_COD	Indicates QTAB_ERR or MLAB_ERR but operation performed.
-828	ICUV_COD	Indicates ICU version updated.
-829	ICUV_REB	Indicates ICU version updated & rebuild required.
-832	ITMP_COD	Indicates sysiocod value when ITIM_ERR occurs on a temporary index and record is skipped.
-837	IDUP_COD	Indicates sysiocod value when KDUP_ERR occurs on a temporary index and error is ignored.
-840	CTRN_COD	Indicates sysiocod when read only, admin open request blocked by on the fly CLNIDXX.
-844	BTNO_COD	Indicates batch has been closed.
-848	RDND_COD	Indicates sysiocod: LOKDYN demotion denied
-849	SAVP_COD	Indicates sysiocod: LOKDYN free denied
-885	OCHK_COD	Indicates a sysiocod value that indicates this API call to perform a checkpoint took no action because a checkpoint was already in progress.
-972	PRTL_COD	If the purgeIFIL option is used, a copy of the partial record is placed in a temporary file; the record is overwritten with 0xff bytes; and sysiocod is set to PRTL_FF.
-973	PRTL_COD	Indicates sysiocod is set to PRTL_COD if rebuild detects a partial record (or resource) at the end of a truncated data file. If the purgeIFIL option is used, a copy of the partial record is placed in a temporary file; the record is overwritten with 0xff bytes; and sysiocod is set to PRTL_FF. If the record is successfully dumped to the temporary file, but there is a problem overwriting the partial record with 0xff bytes, sysiocod will be set to PRTL_COD not PRTL_FF. Whether or not the purge option is used, CTSTATUS.FCS contains the byte offset and length of the partial record. (Prior to V10.3, the values of PRTL_COD and PRTL_FF were ‑970 and ‑971 respectively.)
-974	LWRT_COD	Indicates an attempt to write to log files when ctQTblockLogFiles is in force. (Prior to V10.3, the value of this error code was ‑972)
-975	FNOP_COD	Indicates sysiocod value to caller of file open that the file is not already open. (Prior to V10.3, the value of this error code was ‑10)
-976	FNOR_COD	Indicates sysiocod value to the caller of ctrcvopn81() that FNOP_ERR occurred because the file is not on the dump recovery list. (Prior to V10.3, the value of this error code was ‑11)
-988	CLSF_COD	Indicates internal routine try_FBclsfile successfully closed a low-level index file during an ISAM file block.
-989	OPNF_COD	Indicates internal routine try_FBopnfile successfully re-opened a low-level index file during an ISAM file block.
-1009	COFL_COD	Indicates special internal file open cannot use ctXOPN_COFILE_FILELOCK attribute.
-1024	DLKT_COD	Indicates table lock could not be obtained because the table is locked, or a request to lock the table is pending, or a conflicting data record read or write lock exists.
-1029	UPDM_COD	Indicates index node split has been deferred, the key marks cleaned up to the extent possible, and the add key will be retried.
-1033	QREP_COD	Indicates sysiocod value when ctReplGetNextChange() returns NTIM_ERR and quiesce is waiting for replication readers to finish process committed transactions.
-1041	RUCBDLL_NOT_LOADED_COD	Indicates sysiocod value when a file open succeeds even though the record update callback DLL was not loaded for data file.
-1042	FORCE_BLOCKING_LOCK_COD	indicates sysiocod value set internally when a non-blocking lock request is forced to block.
-1043	FILE_ALREADY_OPEN_COD	Indicates sysiocod value set when a caller requested to know that the file is already open.
-1112	FFTI_COD	Indicates sysiocod value when the FNOP_ERR error is caused by missing FTI file(s).
-1185	TIMEOUT_ON_LAST_LOG_ENTRY	Indicates the sysiocod value when ctReplGetNextChange() returns NTIM_ERR on the last log entry in the transaction log.
-1196	DEFRAG_NO_TRUNCATE_COD	Indicates an online file compaction completed, but was unable to reduce the file size on disk due to exceptional activity.
-1204	REACHED_MAX_LOG_READ_POSITION	Indicates the sysiocod value when `ctReplGetNextChange()` returns `NTIM_ERR` on the log position at which the replication agent is to stop reading the log.