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

3.2 cobfa_delcurr()

Delete the current record after a sequentially read (sequential delete).

long  cobfa_delcurr  (
  long  fd            /* file descriptor */
);

Description

The current record is deleted from the file indicated by the file descriptor <fd>.

Execution Conditions

File Organization

Sequential file

-

Record sequential file

-

Relative file

Executable (*)

Indexed file

Executable (*)

Open Mode

INPUT mode

-

OUTPUT mode

-

I-O mode

Executable (*)

EXTEND mode

-

Access Mode

Sequential

Executable (*)

Random

-

Dynamic

-

* : The record must have been positioned by a sequential read.

Return Values

0: Successful

Function executed successfully

-1: Failed

Function failed. To get extended error information, call the cobfa_errno or cobfa_stat functions

Generated Status

Return value of cobfa_errno ()

Return value of cobfa_stat ()

Successful

FA_ENOERR

0

Function executed successfully

Failure (not all) (*)

FA_ENOTOPEN

49

The specified file is opened in a mode other than I-O mode. Alternatively, an invalid file descriptor is specified.

FA_EBADACC

90

The file is opened with a file organization or access mode that does not allow this function to be executed.

FA_ELOCKED

99

The record positioned by sequential read is locked

FA_ENOCURR

43

Sequential read in the specified file had failed

* : Typical status values are described above. For other values, see "Chapter 5 Error Number and I-O Status".