Write a record sequentially (sequential write).
long cobfa_wrnext ( long fd, /* file descriptor */ const char *recarea, /* record area */ long reclen /* written record length */ );
Description
In the file indicated by the file descriptor <fd>, a record is written sequentially according to the contents in the record area <recarea>.
The written record length <reclen> is valid only if the file is in the variable-length format.
Execution Conditions
File Organization | Sequential file | Executable |
Record sequential file | Executable | |
Relative file | Executable | |
Indexed file | Executable | |
Open Mode | INPUT mode | - |
OUTPUT mode | Executable | |
I-O mode | - | |
EXTEND mode | Executable | |
Access Mode | Sequential | Executable |
Random | - | |
Dynamic | - |
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_EDUPL | 22 | Since duplication of the primary record key is not permitted, this function cannot be executed |
FA_EBADLENG | 44 | The specified written record length value is out of the permissible range | |
FA_ENOTOPEN | 48 | The specified file is opened in INPUT mode. Alternatively, an invalid file descriptor is specified | |
* : Typical status values are described above. For other values, see "Chapter 5 Error Number and I-O Status".
