CBL_WRITE_FILE

Writes bytes to a file.

Syntax:
call "CBL_WRITE_FILE" using  file-handle
                            file-offset
                            byte-count
                            flags
                            buffer
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
file-handle cblt-bytestream-handle pic x(4) comp-5.
file-offset cblt-x8-compx pic x(8) comp-x.
byte-count cblt-x4-compx pic x(4) comp-x.
flags cblt-x1-compx pic x comp-x.
buffer pic x(n). pic x(n).
On Entry:
file-handle The file handle returned when the file was opened.
file-offset The offset in the file at which to write. This field is currently limited to a maximum value of x"00FFFFFFFF".
byte-count The number of bytes to write.

Putting a value of zero in this field causes the file to be truncated or extended to the size specified in the file-offset field.

flags This parameter can take the following value:
0 Standard write
buffer The buffer from which the bytes are written. It is your responsibility to ensure that the buffer is large enough to hold the number of bytes to be written.
On Exit:

None

Comments:

The success of the call can be checked by examining RETURN-CODE.

See Also: