Top
NetCOBOL V11.0 COBOL File Access RoutinesUser's Guide
FUJITSU Software

5.1 Error Number

Error numbers and their meanings are explained below.

Table 5.1 Error number and meanings

Error Number

Meanings

FA_ENOERR

Execution of the I-O feature or file information acquisition is successful.

FA_ENOSPC

Insufficient disk space.

FA_EDUPL

Key duplication error. The status is one of the following:

  • The value of the record key not permitting duplication is duplicated.

  • The value of a relative record number is duplicated.

FA_ENOTOPEN

File open error. The status is one of the following:

  • The file is not opened yet.

  • The file is opened in a mode other than the open mode that allows execution of this feature.

FA_EBADARG

Argument error. The status is one of the following:

  • The record area address is the NULL pointer.

  • For a function for file information acquisition, the function number is out of the range.

  • For a function for file information acquisition, the structure pointer is NULL.

FA_EBADKEY

Indexed file record key specification error. The status is one of the following:

  • The record key list is improperly constructed.

  • The record key list provided does not match the file key list.

  • The record key number is out of range.

FA_ETOOMANY

An attempt was made to open the number of files that exceeded the limit given by the OS or this access routine.

FA_EBADFILE

File structure error. The status is one of the following:

  • The file internal information is incorrect or has been destroyed.

  • The correct file organization has not been specified.

FA_ELOCKED

The record is locked.

FA_EENDFILE

An end of file condition occurred.

FA_ENOREC

The specified record does not exist.

FA_ENOCURR

Positioning to the record is undefined.

FA_EFLOCKED

The file is already opened exclusively.

FA_EFNAME

Error on the filename given when the file was opened. The status is one of the following:

  • The file does not exist.

  • The file cannot be accessed.

  • The filename is a NULL pointer or void string.

  • Filename organization is incorrect.

  • An attempt was made to open a file with the read-only attribute in a mode other than INPUT mode.

FA_EBADMEM

Acquisition of the necessary memory for executing the feature failed.

FA_EKEYSEQ

Key sequence error or key change error. The status is one of the following:

  • The primary record key value is not in ascending order in sequential write.

  • The primary record key value was changed with sequential rewrite.

FA_EBADACC

The combination of parameters is invalid. The status is one of the following:

  • Execution of a feature violating the access mode is requested.

  • The feature cannot be executed with this file organization.

  • The flag combination provided when the file is opened is incorrect.

FA_EBADFLAG

The value specified for the flag is incorrect. The status is one of the following:

  • An unusable mode is specified for the open mode, read mode, or positioning mode.

  • An unacceptable value is specified for the flag.

FA_EBADLENG

Length error. The status is one of the following:

  • The record length exceeds the permissible range.

  • The valid key length for positioning exceeds the permissible value.

FA_EUNDEFKEY

When a file is opened specifying the dummy file function and the record key specification is omitted, index file information cannot be acquired. See "3.26 Dummy File" for details.

FA_EOTHER

An error other than the above occurred. Obtain the return value of the cobfa_stat () function and check the status. For the cobfa_stat() function, see "3.18 cobfa_stat()".