CBL_FLUSH_FILE
Ensures all file buffers for a file are written to disk. This includes both
run-time system buffers and operating system buffers.
Syntax:
call "CBL_FLUSH_FILE" using file-handle
Parameters:
|
Using call prototype (see Library Routines - Key) |
Picture (32-bit systems) |
file-handle |
cblt-bytestream-handle |
pic x(4) comp-5 |
On Entry:
file-handle |
The file handle returned when the file was opened (by CBL_OPEN_FILE). |
On Exit:
RETURN-CODE |
Indicates whether the routine was successful:
0 |
Success |
-1 |
Buffers might not have been flushed |
Other |
Two-byte file status code indicating the error | |
Comments:
On some operating systems it is not possible to flush the file buffers. In
this case, the appropriate status code is returned.
The success of the call can be checked by examining RETURN-CODE.
See Also: