home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0766.lha / ISAM / ISAMErrors.doc < prev    next >
Text File  |  1992-11-21  |  11KB  |  280 lines
  1.  
  2.                       ================================
  3.                       = SOME COMMENTS ON ERROR CODES =
  4.                       ================================
  5.  
  6. ERROR_BLANK_LINE
  7.    - This is returned when a blank line is found where a data/index file
  8.      name was expected.
  9.  
  10. ERROR_CANNOT_DELETE_DATA_FILE
  11. ERROR_CANNOT_DELETE_INDEX_FILE
  12.    - These are returned from DeleteISAMFile.
  13.  
  14. ERROR_CANNOT_SET_ONEXIT
  15.    - this is returned from the first function attempted, if for some reason
  16.      the exit trap couldn't be set. [OBSOLETE - WILL NOT BE RETURNED]
  17.  
  18. ERROR_CONFLICTING_UorR
  19.    - this is returned from CreateISAMFile and ReIndexISAMFile.
  20.      Two or more keys have the same offset and size, but one is designated
  21.      as unique, and the other repeatable.  This is not possible.
  22.  
  23. ERROR_DATA_END_OF_FILE
  24.    - This shouldn't happen (and probably should be an Internal Error).
  25.  
  26. ERROR_DATA_FILE_NOT_FOUND
  27.    - This is returned from OpenISAMFile.
  28.  
  29. ERROR_DELETED_RECORD
  30.    - This is returned from ReadISAMRecord, ModifyISAMRecord,
  31.      DeleteISAMRecord, LockISAMRecord and UnLockISAMRecord.
  32.      The RecNo supplied refers to a deleted record.
  33.  
  34. ERROR_FILE_ALREADY_OPEN
  35.    - This is returned from OpenISAMFile.
  36.      The user has the file open already, but tried to open it again.
  37.  
  38. ERROR_FILE_IN_USE
  39.    - This is returned from CreateISAMFile, ReIndexISAMFile, and
  40.      DeleteISAMFile.
  41.      An ISAM file may not be Created, ReIndexed, or Deleted if another
  42.      user has the file open.
  43.  
  44. ERROR_FILE_LOCKED
  45.    - Another user has the file locked in a mode incompatible with the
  46.      current function.
  47.  
  48. ERROR_FILE_NOT_OPEN
  49.    - This is returned from any function that deals with a specific file,
  50.      when that file has not been opened by the user calling that function.
  51.  
  52. ERROR_FROM_KEY_MISSING
  53. ERROR_FROM_KEY_PRESENT
  54.    - These are returned from SetUpISAMIterationRange.
  55.      The iteration type specifies that the From key should/shouldn't be
  56.      present, and it wasn't/was.
  57.  
  58. ERROR_INCOMPLETE_KEY_LINE
  59.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  60.      A key specification line in the Specs File is missing some
  61.      necessary information.
  62.  
  63. ERROR_INCOMPLETE_PATH
  64.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  65.      The data and index files must have fully specified paths.
  66.      That is, they must have a ":" in the path (preceded by either a
  67.      [logical] device or volume name).
  68.  
  69. ERROR_INDEX_FILE_NOT_FOUND
  70.    - This is returned from OpenISAMFile.
  71.  
  72. ERROR_INSUFFICIENT_MEMORY
  73.    - This is returned from almost everywhere.
  74.      
  75. ERROR_INVALID_AorD
  76.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  77.      Either some intervening specification was left out, or
  78.      the Ascending/Descending character was not "A" or "D".
  79.  
  80. ERROR_INVALID_DATA_FILE
  81.    - This is returned from OpenISAMFile.
  82.      An index file was listed where the data file was supposed to be.
  83.      (The first line of the specs file is where the data file is listed.
  84.      The second line is for the index file.)
  85.  
  86. ERROR_INVALID_DATA_FILE_SIZE
  87.    - This is returned from ReadISAMRecord, ModifyISAMRecord,
  88.      DeleteISAMRecord, and ReIndexISAMRecord.
  89.      Only a partial read was possible, indicating that the data file size
  90.      was not an even multiple of the record size (+1).
  91.      For Read/Modify/Delete, this may indicate trouble.
  92.      For ReIndex, it may just mean that an attempt was made to change the
  93.      record size, which ReIndex can't do.
  94.  
  95. ERROR_INVALID_INDEX_FILE
  96.    - This is returned from OpenISAMFile.
  97.      A data file (or some non-ISAM-related file) was listed where the
  98.      index file was supposed to be.
  99.      (The first line of the specs file is where the data file is listed.
  100.      The second line is for the index file.)
  101.  
  102. ERROR_INVALID_ITERATION_TYPE
  103.    - This is returned from SetUpISAMIterationRange.
  104.      Valid types are: 0 - 9.
  105.  
  106. ERROR_INVALID_KEY_LENGTH
  107.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  108.      The key length was not a number, or is invalid for the key type,
  109.      or the key length + key offset yields an amount larger than the
  110.      record length.
  111.  
  112. ERROR_INVALID_KEY_OFFSET
  113.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  114.      The key offset was not a number, or is beyond the end of the record.
  115.      The key offset must be less than the record size.
  116.  
  117. ERROR_INVALID_KEY_TYPE
  118.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  119.      Either some intervening specification was left out, or the type is
  120.      invalid.
  121.      Valid types are: A, T, C, I, F.
  122.    - This is also called from SetUpISAMIterationPrefix, if the key is
  123.      not type A, T, or UI.
  124.  
  125. ERROR_INVALID_LOCK_TYPE
  126.    - This is returned from LockISAMRecord, LockISAMFile, StoreISAMRecord,
  127.      OpenISAMFile, ReadISAMRecord, ReadUniqueISAMRecord, ReadNextISAMRecord.
  128.      Valid types are: R, W.
  129.  
  130. ERROR_INVALID_PREFIX_LENGTH
  131.    - This is returned from SetUpISAMIterationPrefix.
  132.      Either the prefix length specified is longer than the key length,
  133.      or the prefix length specified is zero, and strlen( prefix ) is
  134.      longer than the key length.
  135.  
  136. ERROR_INVALID_RECORD_LENGTH
  137.    - This is called from CreateISAMFile and ReIndexISAMFile.
  138.      Either the record size was not a number, or was less than 4.
  139.      A record must be at least 4 bytes in length.
  140.  
  141. ERROR_INVALID_UorR
  142.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  143.      Either some intervening specification was left out, or
  144.      the Unique/Repeatable character was not "U" or "R".
  145.  
  146. ERROR_ISAM_ALREADY_INSTALLED
  147.    - This is returned from an attempted second installation of ISAM.
  148.      ISAM may only be installed once in memory.
  149.  
  150. ERROR_ISAM_NOT_INSTALLED
  151.    - This is returned from any function.
  152.      ISAM is not installed.
  153.  
  154. ERROR_ISAM_SHUTTING_DOWN
  155.    - This is returned from any function.
  156.      Someone is in the process of shutting down ISAM.
  157.      All functions already waiting for ISAM's attention return this after
  158.      ISAM receives the command to shut down.
  159.  
  160. ERROR_KEY_IS_ASCENDING
  161. ERROR_KEY_IS_DESCENDING
  162.    - This is returned from SetUpISAMIterationRange.
  163.      Either the From Key is after the To Key and the key is an ascending key,
  164.      or the From Key is before the To Key and the key is a descending key.
  165.      Either way, the From Key and To Key are in the wrong order.
  166.  
  167. ERROR_KEY_LINE_TOO_LONG
  168.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  169.      After all necessary information was obtained from a key line, there were
  170.      still characters left over.
  171.  
  172. ERROR_KEY_NOT_UNIQUE
  173.    - This is returned from ReadUniqueISAMRecord.
  174.      The key number indicated referred to a Repeatable key.
  175.  
  176. ERROR_MAX_FILES_OPEN
  177.    - This is returned from OpenISAMFile.
  178.      The maximum number of different ISAM files that can be open, are open
  179.      and a request to open another one was made.
  180.      Specify a higher maximum the next time ISAM is installed.
  181.  
  182. ERROR_NO_FREE_SIGNALS
  183.    - This is returned from the first function attempted.
  184.      In order to communicate with the server, a message port has to be set
  185.      up, with a signal bit allocated from the user's task.  If there are
  186.      no more free signals available, this error is returned.
  187.      This is not likely, as there are 16 user signals per task.
  188.  
  189. ERROR_NO_KEY_INFO
  190.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  191.      There were no keys specified in the Specs File.
  192.  
  193. ERROR_NO_MORE_RECORDS
  194.    - This is returned from ReadNextISAMRecord and ReadNextISAMKey.
  195.      This is not an error.
  196.      The iteration SetUp previously is over - no more records meet the
  197.      SetUp criteria.
  198.  
  199. ERROR_NO_SUCH_KEY
  200.    - This is returned from any function with a key number parameter.
  201.      There is no such key for the given file.
  202.  
  203. ERROR_NO_SUCH_RECORD
  204.    - This is returned from ReadUniqueISAMRecord.
  205.      No record with the key value specified exists in the file.
  206.  
  207. ERROR_NULL_POINTER
  208.    - This is returned whenever a pointer to something is given as
  209.      a paramter.
  210.      The pointer contained the value NULL, and thus was invalid.
  211.  
  212. ERROR_RECORDS_LOCKED
  213.    - This is returned from OpenISAMRecord.
  214.      The attempt to open the file failed because the user wanted the
  215.      file locked, and another user had records in that file locked.
  216.  
  217. ERROR_RECORD_EXISTS
  218.    - This is returned from StoreISAMRecord and ModifyISAMRecord.
  219.      This file has a unique key, and a search of the file showed that
  220.      a record already exists in the file with the same key value as the
  221.      record that the user is attempting to Store/Modify.
  222.  
  223. ERROR_RECORD_LOCKED
  224.    - Another user has the record locked in a mode incompatible with the
  225.      current function.
  226.  
  227. ERROR_RECORD_TOO_HIGH
  228.    - This is returned from ReadISAMRecord, ModifyISAMRecord,
  229.      DeleteISAMRecord, LockISAMRecord and UnLockISAMRecord.
  230.      The RecNo supplied refers to a position beyond the end of the data file.
  231.  
  232. ERROR_RENAME_FAILED_IN_REINDEX
  233.    - This is returned from ReIndexISAMFile.
  234.      ReIndex calls Create to make the index file.  Create deletes both
  235.      data and index files, if they exist.  Therefore, ReIndex first
  236.      renames the data file.  Afterwards, it renames it back.
  237.      Here, it couldn't do one or the other, for some reason.
  238.  
  239. ERROR_SPECS_FILE_EMPTY
  240.    - This is returned from CreateISAMFile and ReIndexISAMFile.
  241.      There was nothing specified beyond the data/index file names in 
  242.      the Specs File.
  243.  
  244. ERROR_TO_KEY_MISSING
  245. ERROR_TO_KEY_PRESENT
  246.    - These are returned from SetUpISAMIterationRange.
  247.      The iteration type specifies that the To key should/shouldn't be
  248.      present, and it wasn't/was.
  249.  
  250.  
  251.  
  252.     --------------------------------------------------------------
  253.      the following are INTERNAL errors (note the "I") and are
  254.      unlikely to be returned.  If they are, report them to us.
  255.      Copy the problem specs/data/index files onto a floppy disk,
  256.      and jot down a note (file or paper) providing the name and
  257.      parameter values of the function that returned the error,
  258.      along with a copy of the ISAMStatus report, and ISAMFileReport
  259.      for the problem file, both run immediately after the error.
  260.  
  261.      After copying the files/reports/function description onto the
  262.      floppy, run ReIndex on the file.  The problem may just go away.
  263.      Do let us know about it, in any case.  If we don't know about
  264.      bugs, we can't fix them!
  265.     --------------------------------------------------------------
  266.  
  267. IERROR_DELETED_KEYNODE
  268. IERROR_HEADER_KEYNODE
  269. IERROR_INDEX_END_OF_FILE
  270. IERROR_INVALID_AorD
  271. IERROR_INVALID_INDEX_FILE_SIZE
  272. IERROR_INVALID_ISAM_COMMAND
  273. IERROR_KEYNODE_TOO_HIGH
  274. IERROR_KEY_VALUE_NOT_FOUND
  275. IERROR_NOT_DELETED_KEYNODE
  276. IERROR_NOT_DELETED_RECORD
  277. IERROR_NO_FFILE_FOR_TFILE
  278. IERROR_NO_RECORDS_IN_FILE
  279.  
  280.