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:
-
file-handle
- Call prototype: cblt-bytestream-handle
- Picture: 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.