Errors for Remaining File Types [ COBOL/HP-UX Operating Guide for the Series 700 and 800 ] MPE/iX 5.0 Documentation
COBOL/HP-UX Operating Guide for the Series 700 and 800
Errors for Remaining File Types
These error messages apply to LEVEL II and Micro Focus indexed files,
relative files, sequential and line sequential 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 2
significant settings for status1; 5 which points to certain indexed
errors, and 9 which points to errors for all file types including
indexed.
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 tried to delete the primary key value. You may not 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, with the value of
status2 set to one of the following numbers, which indicates the type of
error. These are as follows:
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 use the open call to a file that you
have opened with a previous call. You may not 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 has been unable to locate the file
which you have attempted to access in your program.
014 Too many files open simultaneously
* You have tried to exceed the maximum number of files
which you can hold 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 are able to 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 are attempting 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.
* You will need to change your program giving the correct
file name.
024 Disk input-output error
* This error could be given if:
* you use the read call after writing to a file, or:
* 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 are attempting 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 attempted a file operation for which there is
not sufficient space on your device.
029 Attempt to delete open file
* You have tried to delete an open file.
* You should close the file before trying to delete it.
030 File system is read-only
* You have tried to change information in a file that is
read only. A read only file permits 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 carry out the call you
have made to the file.
* You must 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 are either trying to write to a file that is open for
INPUT, or read a file that is open for OUTPUT.
* You need to close the file and use the open call with the
correct parameter for the open mode.
035 Attempt to access file with incorrect permission
* You are attempting a file operation which you do not have
permission to achieve.
* Corrective action depends on file ownership conditions:
* if you are the file owner you should change the
file attributes to enable you to carry out the
operation, or:
* if you are not the file owner you will not be able
to carry out the operation on the source file, but
you could to a copy of the file.
036 File already exists
* You are attempting an inappropriate operation on an
already existing file.
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).
* You will need to alter the access permission to the
relevant file to continue.
039 File not compatible
* You are trying to load a file that is not compatible with
the structure of files under your current release of
software.
* You will need to 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, or:
* does not exist, or:
* 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 two conditions:
* you may see this error 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)
* this message can indicate that 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 a further 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 by another user.
066 Attempt to add duplicate record key to indexed file
* You have attempted to add a duplicate key to the index of
an indexed file which does not allow duplicate keys.
* You will need to redefine the key for this call to
succeed.
067 Indexed file not open
* You are trying to access an indexed file which you have
not opened.
* You must make a call to open the file before 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 are attempting to open an indexed file, however the
system limit for open indexed files is expended.
071 Bad Indexed file format
* There can be one of two reasons for this error message:
* the file has been corrupted, or:
* there is an internal system error
* If it is a system error 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.
* You need to check with the documentation for your
operating system to make sure you are using the correct
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 made
a rewrite call to a file that has failed because the
record to be rewritten has not been set as the current
record. One way to make the record you want to rewrite
the current record is to make a read call to the record
first (making it the current record), then use the
rewrite call.
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, or:
* the sequential file you are attempting to access
is corrupt in some way, or:
* the file you have specified is not a sequential
file.
105 Memory allocation error
* Sufficient memory space is not available to successfully
carry out the attempted operation. This error implies
there is no memory space left in your system.
* You will need to 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, or:
* an internal system error, 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
* For some reason there is not sufficient memory to enable
you 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.
* You should ensure the value in 'rlrecnum' is equal to the
record you wish to access.
135 File must not exist
* You have attempted 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 as 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 made a call 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 made
a call to 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 wish
to rewrite.
* You should attempt a read call to the file to define the
current record before you try to rewrite it.
146 No current record defined for sequential read
* The current record is undefined owing to a failed read,
start 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.
* You should attempt a start or read call to the file to
define the current record.
147 Wrong open mode or access mode for read/start
* You have tried to make a read or start call to 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 are trying to rewrite or delete a record in a file
that you have not opened in I-O mode.
* Close the file and when you make the open call to the
file, make sure you use the I-O mode.
150 Program abandoned at user request
* You have stopped the program by means of a keyboard
interrupt. The program closed tidily, and any open files
were closed.
151 Random read on sequential file
* You are trying to randomly read a file which has a
sequential organization.
* Make sure you use the correct read call for the file.
152 Rewrite on file not open I-O
* You have attempted 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 can only use the lsrewcurr 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 are trying 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. You must 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.
* You need to check with the documentation for your
operating system 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.
* You should spread the data over more than one file.
196 Record number too large in relative or indexed file
* This error may have one of three causes:
* the relative record key has exceeded the limit,
that is the file is too large for the system to
handle, or:
* the record key which you have specified is too
large for the system to deal with successfully,
or:
* 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 can be two causes for this error:
* the amount of memory available is too low to load
the run-time system, or:
* 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, you will
need to 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