FATS - Fast Access Tree System
	Table of Contents
		Errorcodes

Errorcodes

The possible errorcodes that FATS returns are described below:

4 key type error
The format of the key value you specified in the command is invalid.

5 Generic Search on Integer key
The Search Generic (G) command can not be used with integer keys.

6 Key not found (on delete)
The specified primary key(s) was not found.

7 Number of primary keys
The number of primary keys included in the command string must equal the number specified in the Create Indexfile (C) command.

8 Syntax error in the command string
The syntax (parameters) of the command string you specified in the FATS call is invalid.

9 Too many levels in tree
FATS is unable to extend the index file.

10 Key value larger than maximum
The length of the key value you specified must not exceed the defined maximum length of the primary key. (see Create Indexfile (C) command)

11 File not opened
An application must perform a successful open operation before FATS can process any other operations.

12 Key not found, found keys are larger and smaller (warning)
There is no key which equals the value specified over "KeyString". FATS returns the record number and key value of the adjacent smaller key in RECNO and FATSKEY.

13 Key not found, first key is returned (warning)
The specified key was not found because it is smaller than all keys in the index file. FATS returns the first key in the file.

15 Key not found last key is returned (warning)
The specified key was not found because it is greater than all keys in the index file. FATS returns the last key in the file.

16 No keys in index file
No key was inserted into the index file.

22 File not found
The file specified with the Open Indexfile (O) command does not exist or is opened in exclusive mode by another station.

23 Create file error
The file name specified could not be created. Possible causes are a full disk directory, a full disk or a write protected disk.

24 Disk full
The disk is full and will not allow the index file to be expanded to process the specified command.

25 Write error
An error occured during disk write.

26 File not present (when closed)
An error occured switching between the current directory and the directory which contains the index file. FATS is unable to update the directory entry of the file while using File Control Blocks (FCB).

27 Read error
An error occured during disk read. This errorcode may indicate that the file has been damaged and must be recreated (see also errorcode 253).

28 DOS I/O-error
An error occured during disk access. This errorcode indicates a device I/O error from the operation system.
The error subcode from the DOS function "Get Extended Error" will be returned in the "RECNO" parameter.

144 Network lock error
The specified command cannot be performed because another station helds the temporary lock on the index file. Normally FATS will wait for a index file to become available when another station holds the lock for that file. You can change this behavior with the Auto Refresh (Y) command.

145 Network error
FATS returns this error if the lock function call to the operation system failed. One cause is that the Server lock table is full.

241 Trial version expired
FATS is unable to open the index file because the trial version is expired. If your trial period has expired, then you need to request for an extension. Simply downloading it again or reinstalling will not extend the trial period.

243 EMS-hardware-error
(only extended version)

244 Invalid page size
(only extended version)

245 No support for compressed keys
An attempt was made to access a file containing compressed keys with a version of FATS that does not support this feature.

246 No support for variable length record numbers
An attempt was made to access a file containing variable length record numbers with a version of FATS that does not support this feature.

247 All record numbers are reserved
(only extended version)

248 Wrong access mode
An attempt has been made to open a index file in an network compatible mode (Y\2,Y\3,Y\106..), but no network was found by FATS, this means that SHARE or NETX are not loaded.

249 Insufficient memory
FATS cannot allocate the needed memory for the specified command from its internal heap managment. This error can occur if you open many index files with a large number of primary keys specified by the Create Indexfile (C) command. Try closing some files or ask GCSSOFT for the extended version of FATS, which overcomes this problem by supporting Extended Memory.

250 Duplicate key value
An attempt was made to add a key value that already exists in the specified key file. (extended version)

253 Corrupted index file
If FATS was abnormally terminated during its previous execution, it may not be able to open the index file because the file integrity cannot be guaranteed. Either rebuild the index file or replace it with its most recent backup.
This error may also occur if you try to open a FABS Plus file that has not been converted to the FATS index format.

254 Internal Error
An internal software error occurred during execution.
Please send any information you can provide about the version of the software you are using or what you were doing prior to the error to the following address:
GCS Software
Am Gänskragen 10
73230 Kirchheim/Teck

4	key type error The format of the key value you specified in the command is invalid.
5	Generic Search on Integer key The Search Generic (G) command can not be used with integer keys.
6	Key not found (on delete) The specified primary key(s) was not found.
7	Number of primary keys The number of primary keys included in the command string must equal the number specified in the Create Indexfile (C) command.
8	Syntax error in the command string The syntax (parameters) of the command string you specified in the FATS call is invalid.
9	Too many levels in tree FATS is unable to extend the index file.
10	Key value larger than maximum The length of the key value you specified must not exceed the defined maximum length of the primary key. (see Create Indexfile (C) command)
11	File not opened An application must perform a successful open operation before FATS can process any other operations.
12	Key not found, found keys are larger and smaller (warning) There is no key which equals the value specified over "KeyString". FATS returns the record number and key value of the adjacent smaller key in RECNO and FATSKEY.
13	Key not found, first key is returned (warning) The specified key was not found because it is smaller than all keys in the index file. FATS returns the first key in the file.
15	Key not found last key is returned (warning) The specified key was not found because it is greater than all keys in the index file. FATS returns the last key in the file.
16	No keys in index file No key was inserted into the index file.
22	File not found The file specified with the Open Indexfile (O) command does not exist or is opened in exclusive mode by another station.
23	Create file error The file name specified could not be created. Possible causes are a full disk directory, a full disk or a write protected disk.
24	Disk full The disk is full and will not allow the index file to be expanded to process the specified command.
25	Write error An error occured during disk write.
26	File not present (when closed) An error occured switching between the current directory and the directory which contains the index file. FATS is unable to update the directory entry of the file while using File Control Blocks (FCB).
27	Read error An error occured during disk read. This errorcode may indicate that the file has been damaged and must be recreated (see also errorcode 253).
28	DOS I/O-error An error occured during disk access. This errorcode indicates a device I/O error from the operation system. The error subcode from the DOS function "Get Extended Error" will be returned in the "RECNO" parameter.
144	Network lock error The specified command cannot be performed because another station helds the temporary lock on the index file. Normally FATS will wait for a index file to become available when another station holds the lock for that file. You can change this behavior with the Auto Refresh (Y) command.
145	Network error FATS returns this error if the lock function call to the operation system failed. One cause is that the Server lock table is full.
241	Trial version expired FATS is unable to open the index file because the trial version is expired. If your trial period has expired, then you need to request for an extension. Simply downloading it again or reinstalling will not extend the trial period.
243	EMS-hardware-error (only extended version)
244	Invalid page size (only extended version)
245	No support for compressed keys An attempt was made to access a file containing compressed keys with a version of FATS that does not support this feature.
246	No support for variable length record numbers An attempt was made to access a file containing variable length record numbers with a version of FATS that does not support this feature.
247	All record numbers are reserved (only extended version)
248	Wrong access mode An attempt has been made to open a index file in an network compatible mode (Y\2,Y\3,Y\106..), but no network was found by FATS, this means that SHARE or NETX are not loaded.
249	Insufficient memory FATS cannot allocate the needed memory for the specified command from its internal heap managment. This error can occur if you open many index files with a large number of primary keys specified by the Create Indexfile (C) command. Try closing some files or ask GCSSOFT for the extended version of FATS, which overcomes this problem by supporting Extended Memory.
250	Duplicate key value An attempt was made to add a key value that already exists in the specified key file. (extended version)
253	Corrupted index file If FATS was abnormally terminated during its previous execution, it may not be able to open the index file because the file integrity cannot be guaranteed. Either rebuild the index file or replace it with its most recent backup. This error may also occur if you try to open a FABS Plus file that has not been converted to the FATS index format.
254	Internal Error An internal software error occurred during execution. Please send any information you can provide about the version of the software you are using or what you were doing prior to the error to the following address: GCS Software Am Gänskragen 10 73230 Kirchheim/Teck