HP 3000 Manuals

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