File-specific Error Codes [ Micro Focus COBOL System Reference, Volume 2 ] MPE/iX 5.0 Documentation
Micro Focus COBOL System Reference, Volume 2
File-specific Error Codes
Certain errors are associated only with C-ISAM
and X/Open compliant files. Other errors are associated mainly with
other types of indexed files (LEVEL II COBOL and the indexed format
supported by this COBOL system) plus relative, sequential and line
sequential files. Therefore, the following sections are divided between
C-ISAM and X/Open compliant files and other file types. Using C-ISAM and
X/Open compliant files, the error numbers are important, whilst for the
remaining file types only the status codes are significant.
Errors Associated with C-ISAM and X/Open Files
Error numbers are from -1 to 99 for operating system errors and greater
than 99 for other errors. If the error is from the operating system, you
must check the errors associated with that system. Unlike the other file
types, the errors are identified by the error number, rather than the
status codes.
The following errors numbers identify the following X/Open and C-ISAM
errors:
100 EDUPL Duplicate record
* You tried to add a duplicate value to an index with no duplicates
allowed, or to add an index with no duplicates allowed where there
are duplicate values for the key in the file.
101 ENOTOPEN File not open
* The file you attempted to access is not open, or you did not open
it with the appropriate access mode for the call made.
102 EBADARG Illegal argument
* The argument you have given for the call is outside the valid
range.
103 EBADKEY Illegal key description
* The key description you have given has one or more values outside
the valid range.
104 ETOOMANY Too many files open
* You have tried exceed the maximum number of indexed files which
can be open at any one time.
105 EBADFILE Bad isam file format
* The index information for the file has been corrupted so that the
data is no longer accessible.
* To rebuild the file you can use the File Handler utilities, for
more information see the section fhrebuild Utility in the chapter
File Handler Utilities earlier in this manual.
106 ENOTEXCL Non-exclusive access
* You cannot add or delete an index because you have not opened the
file in exclusive mode.
107 ELOCKED Record locked
* You cannot access the record specified by your call because the
record has been locked by another user.
108 EKEXISTS Key already exists
* You have tried to add an index that already exists.
109 EPRIMEKEY Is primary key
* You have tried to delete the primary key value. You cannot delete
this using the isdelindex call.
110 EENDFILE End/begin of file
* You have reached the end or beginning of the file.
111 ENOREC No record found
* No record can be found in the position you have specified, or by
the value given for isrecnum.
112 ENOCURR No current record
* The call you have made operates on the current record, but either
no record has been defined, or the current record has been
deleted. To define a current record you should make an isread
call to the file.
113 EFLOCKED File locked
* The file you want to access has either been exclusively locked by
another user, or you are attempting to gain an exclusive lock on a
file which is already open by another user.
114 EFNAME File name too long
* The file-name you have given is either too long or is in some way
invalid. You should check your operating system documentation to
ensure you know the correct file-name format.
115 ENOLOCK Can't create lock file
* The lock you have specified for the file cannot be used.
116 EBADMEM Can't allocate memory
* There is not enough memory available to perform the call you have
made.
117 EBADCOLL Bad custom collating
* The collating sequence specified in the key description is
invalid.
120 EBADNLS Bad NLS language
* You have tried to open a file that was created using a different
NLS language to the one you are trying to use.
MPE/iX 5.0 Documentation