Errors for Remaining File Types [ Micro Focus COBOL System Reference, Volume 2 ] MPE/iX 5.0 Documentation
Micro Focus COBOL System Reference, Volume 2
Errors for Remaining File Types
These error messages apply to LEVELII indexed files and the indexed file
format supported by this COBOL system, relativefiles, sequential and
linesequential files. The errors are identified by the status values
rather than the error number. Generally, the error number will be set to
zero if the call is successful, or -1 if the call fails.
If the error number is set to -1 the appropriate values are returned to
the status variables: status1 and status2. There are two significant
settings for status1:
Setting Description
-------------------------------------------------------
5 points to certain indexed errors
9 points to errors for all file types
including indexed.
The error messages produced when status1 is set to 5 and 9 are detailed
in the following sections.
When status1 is Set to 5
Errors only associated with indexed files set status1 to 5, then status2
to one of the following:
1 No Such Index
* The key description you have given has one or more values outside
the acceptable range.
2 Index already exists
* You have tried to add an index that already exists.
3 Prime index
* You have tried to delete the primary key value. You cannot delete
this using the isdelindex call.
4 Not exclusive
* You cannot add or delete an index because you have not opened the
file in exclusive mode.
5 Duplicates present
* The key used in the call permits duplicates.
6 Too many keys
* You have tried to add more keys than the maximum permissible.
When status1 is Set to 9
Errors associated with all file types set status1 to 9.
Status2 is set to one of the following values, which indicates the type
of error:
002 File not open when access attempted
* You have tried to access a file that you have not opened.
005 Illegal device specification
* Devices to which you can write are defined by the operating
system. You have attempted to access a device which is not
defined by your system.
006 Attempt to write to a file opened for INPUT
* You have tried to write to a file which you opened for INPUT only.
* You will need to close the file, and use the open call, making
sure you open it in a compatible mode, for example I-O.
007 Disk space exhausted
* There is no room available on your current disk for file
operations.
008 Attempt to input from a file opened for OUTPUT
* You have tried to read a file which you have opened for OUTPUT
only.
* You will have to close the file, and use the open call in the
correct mode, for example I-O.
009 No room in file system
* There is no room available for further file operations in the file
system you have specified.
012 Attempt to open a file which is already open
* You have tried to open a file that you have opened with a previous
call. You cannot open the same file more than once from within
the same process.
* Note that the call to build a file also opens a file.
013 File not found
* The operating system cannot find the file you are trying to access
in your program.
014 Too many files open simultaneously
* You have tried to exceed the maximum number of files which you can
have open at any one time. This is an operating system restraint
and you must not violate it.
015 Too many indexed files open
* You have tried to exceed the maximum number of indexed files which
you can have open at any one time. This is either a software or
an operating system restraint and you must not violate it.
016 Too many device files open
* You have tried to exceed the maximum number of device files which
you can have open at any one time. This is either a software or
an operating system restraint and you may not violate it.
017 Record error: probably zero length
* You have tried to access a record that has no value in it.
018 Read part record error: eof before eor or file open in wrong mode
* A part record has been found at the end of the file.
019 Rewrite error: open mode or access mode wrong
* You have tried to rewrite a record in a file that has not been
opened in the correct mode for this operation.
* You should close the file, then open it again using the correct
mode, for example I/O.
020 Device or resource busy
* You have tried to open a file that is assigned to a device or
resource that is not available at this time.
021 File is a directory
* You have tried to write a record to a directory instead of a file.
* Change your program giving the correct file-name.
024 Disk input-output error
* This error is given if:
* you use the read call after writing to a file
* there is a verification failure or a parity error.
026 Block I-O error
* An error occurred while you were attempting to access a disk.
This could be the result of a corrupt disk.
027 Device not available
* You have tried to access a device which is either not attached to
your machine or, if attached, is not on-line.
028 No space on device
* You have tried a file operation for which there is not enough
space on your device.
029 Attempt to delete open file
* You have tried to delete an open file.
* Close the file before trying to delete it.
030 File system is read-only
* You have tried to change information in a file that has read only
permissions. A read only file enables you to read information
from a file, but not to alter it in any way.
031 Not owner of file
* You do not have the authority to perform the call you have made to
the file.
* Abandon the call, unless you are given access by the file's owner.
032 Too many indexed files, or no such process
* You have tried to open an indexed file, but the number of files
you have open is the system limit.
* Close some indexed files you are no longer accessing.
033 Physical I-O error
* You have a hardware error of some type, or you may have tried to
write to a disk but the processor detected a hardware interface
problem, so the call has failed.
034 Incorrect mode or file descriptor
* You have either tried to write to a file that is open for INPUT
only, or read a file that is open for OUTPUT only.
* Close the file and open it again with the valid open mode.
035 Attempt to access file with incorrect permission
* You have tried a file operation which you do not have valid file
access permissions.
* If you are the file owner, change the file attributes; otherwise
you cannot perform the operation on the source file. You could,
however, to a copy of the file.
036 File already exists
* You have tried to perform an inappropriate operation on a file
that already exists.
037 File access denied
* Your attempt to access the file has been denied by the operating
system (for example, the file may be write protected).
* Alter the access permission to the relevant file to continue.
039 File not compatible
* You have tried to load a file that is not compatible with the
structure of files under your current release of software.
* Create a new copy of the file with the correct structure.
040 Language Initialization not set up correctly
* The NLS language in the file you are using:
* has not been set up correctly
* does not exist
* is invalid.
041 Corrupt indexed file
* The index information for an indexed file has been corrupted so
that the data is no longer accessible.
043 File information missing for an indexed file
* This message can be generated by either of the following two
conditions:
* if the system crashed on the program's previous run, while
the file was open. This means information was added to the
end of the file, but the index was not updated so the
information cannot be accessed by your system
* you copied an indexed file from one disk to another without
copying both physical files.
047 Indexed structure overflow
* There is a fault in the structure of your indexed file. You have
probably tried to put an addition entry in the index when there is
no room for it.
065 File locked
* You have made an open call to a file that is already locked, or
opened for OUTPUT only by another user.
066 Attempt to add duplicate record key to indexed file
* You have tried to add a duplicate key to the index of an indexed
file which does not allow duplicate keys.
* Redefine the key for this call to succeed.
067 Indexed file not open
* You have tried to access an indexed file which you have not
opened.
* Open the file so that you can access information.
068 Record locked
* You have tried to access a record which is currently locked by
another user.
069 Illegal argument to ISAM module
* This is the result of an internal system error.
* Contact Technical Support.
070 Too many indexed files open
* You have tried to open an indexed file; however the system limit
for open indexed files has been reached.
071 Bad Indexed file format
* There are two reasons for this error message:
* the file has been corrupted
* there is an internal system error, in which case you should
contact Technical Support.
072 End of indexed file
* This is the result of an internal system error.
* Contact Technical Support.
073 No record found in indexed file
* This is the result of an internal system error.
* Contact Technical Support.
074 No current record in indexed file
* This is the result of an internal system error.
* Contact Technical Support.
075 Indexed data file name too long
* The name of the file has too many characters for your operating
system.
* Check with your operating system documentation to make sure you
are using the permitted number of characters for the file-names.
077 Internal ISAM module error
* This is the result of an internal system error.
* Contact Technical Support.
078 Illegal key description in indexed file
* The key description you have given is one or more values outside
the acceptable range.
081 Key already exists in indexed file
* You have tried to add an index that already exists.
100 Invalid file operation
* The most likely cause of this error is that you have tried a
REWRITE operation on a file which has failed because the record to
be rewritten has not been set as the current record.
* Set the record you want to rewrite as the current record by first
making a READ call to the record.
101 Illegal operation on an indexed file
* This is the result of an internal system error.
* Contact Technical Support.
102 Sequential file with non-integral number of records
* There are three possible reasons for this error:
* you have specified an incorrect record length for a
sequential file
* the sequential file you have tried to access is corrupt in
some way
* the file you have specified is not a sequential file.
105 Memory allocation error
* There is not enough memory available to perform the attempted
operation.
* Obtain more memory to run your program. Refer to your operating
system documentation for details.
106 Dictionary error
* There are two possible reasons for this error message:
* a READ or WRITE error to file or disk
* an internal system error, in which case you should contact
Technical Support.
109 Invalid checksum in the Run-Time System
* This is the result of an internal system error.
* Contact Technical Support.
116 Cannot allocate memory
* There is not enough memory to execute your code.
117 Bad collating sequence
* The collating sequence specified in the key description is not
valid.
129 Attempt to access record zero of relative file
* The value you specified in rlrecnum contains the value zero.
* Ensure the value in rlrecnum is equal to the record you want to
access.
135 File must not exist
* You have tried to open for OUTPUT a file that already exists.
* Either open the file for I-O, or supply a new file-name for the
file to be opened for output.
139 Record length or key data inconsistency
* There is a discrepancy in either the length of a record, or the
keys which you have specified in your current program compared to
the call you used to open the file.
141 File already open - cannot be opened
* You have tried to open a file which is already open. You cannot
open a file more than once from within the same process.
142 File not open - cannot be closed
* You have tried to close a file which was not open.
143 Rewrite in sequential mode not preceded by successful read
* The current record is undefined because you have not read the
record first. You have tried to rewrite the record but as the
current record is undefined, the system cannot find the start of
the record you want to rewrite.
* Read the file first, which defines the current record. You can
then rewrite it.
146 No current record defined for sequential read
* The current record is undefined because of a failed READ
operation, START operation or invalid key condition. You have
tried to read another record in the file, but as the current
record is undefined the system cannot find the start of the record
for which you have asked.
* Perform a START or READ operation on the file to define the
current record.
147 Wrong open mode or access mode for read/start
* You have tried to read or start a file which has not been opened
in INPUT or I-O mode, or is not open at all.
148 Wrong open mode for write
* You have tried to write to a file that you have not opened in the
correct mode for output.
* Close the file and open it in the correct mode.
149 Wrong open mode for rewrite/delete
* You have tried to rewrite or delete a record in a file that you
have not opened in I-O mode.
* Close the file and open it again in I-O mode.
150 Program abandoned at user request
* You have stopped the program using a keyboard interrupt. The
program closed tidily, and any open files were closed.
151 Random read on sequential file
* You have tried to randomly read a file which has a sequential
organization.
* Use the correct READ operation for the file.
152 Rewrite on file not open I-O
* You have tried to rewrite a record in a file that is not opened in
the I-O mode.
158 Attempt to rewrite to a line sequential file
* You have tried to rewrite to a file using the Isrewcurr call. You
can only use this call if the record you are rewriting is the same
size as the original record.
159 Malformed line sequential file
* The line sequential file you tried to access is corrupt.
165 Version number incompatibility
* The version of the File Handler you are using is not compatible
with the Run-Time System.
* Make sure you are using the correct versions of software.
180 End of file marker error
* A file marker used to indicate that the end-of-file has been
reached is missing from the file.
181 Invalid parameter error
* The parameter you have specified is not valid.
188 File name too large
* The name of the file has too many characters for your operating
system.
* Check with your operating system documentation to make sure you
are using the correct number of characters for the file-names.
194 File size too large
* The file which your program is accessing is too large for
successful execution to continue.
* Spread the data over more than one file.
196 Record number too large in relative or indexed file
* There are three possible causes for this error:
* the relative record key has exceeded the limit; that is,
the file is too large for the system to process
* the record key that you have specified is too large for the
system to process
* the pointer to the record has been corrupted in some way so
that it is either too large, or is not a multiple of the
record length.
199 Operating system error out of defined range
* A system call has returned an unexpected error number which is not
documented.
* Contact Technical Support.
200 Run-Time system internal logic error
* There are two causes for this error:
* the amount of memory available is too low to load the
run-time system
* the Run-Time System has halted due to an internal logic
error in your program.
* In the first case, freeing extra memory should remedy the problem.
However, in the case of the second problem you should contact
Technical Support.
213 Too many locks
* The file has already acquired the maximum number of locks for a
file allowed by your operating system.
219 Operating system shared file limit exceeded
* You have tried to exceed your operating system's limit on the
number of shared files that you can have open simultaneously.
* As this figure is operating system dependent, consult your
operating system documentation for details of how many shared
files your system permits to be open at any one time.
MPE/iX 5.0 Documentation