CBL_READ_VFILE

Reads bytes from a heap.

Syntax:
call "CBL_READ_VFILE" using by value heap-id
                                     heap-ref
                                     heap-length
                      by reference   heap-buffer
                      returning      status-code
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
heap-id cblt-vfile-handle. pic x(2) comp-5.
heap-ref cblt-x4-comp5. pic x(4) comp-5.
heap-length cblt-x4-comp5. pic x(4) comp-5.
heap-buffer pic x(n). pic x(n).
status-code See Library Routines - Key.
On Entry:
heap-id This contains the heap handle assigned when the heap was opened.
heap-ref Offset in the heap at which to start reading.
heap-length Number of bytes to read.
On Exit:
heap-buffer Buffer into which bytes are read. It is your responsibility to ensure that the buffer is large enough to hold the number of bytes being read.
Comments:

Trying to read data from an area of the heap which has not yet been written results in indeterminate data being returned to the buffer.

See Also: