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. |