The file handle returned when the file was opened.
file-offset
The offset in the file at which to read. This field is currently limited
to a maximum value of x"00FFFFFFFF".
byte-count
The number of bytes to read.
flags
This parameter can take the following values:
0
Standard read
128
Return the current file size in file-offset
On Exit:
file-offset
Contains the current file size on return if flags is set to 128 on entry.
buffer
The buffer into which the bytes are read. It is your responsibility to ensure
that the buffer is large enough to hold the number of bytes to be read.
Comments:
The success of the call can be checked by examining RETURN-CODE.
When using this routine to read a file that is contained in a .lbr file,
the end-of-file status is not returned. To ensure you only read the file you
want, obtain the size of the file first (set flags to 128), and only read
up to that size.