|
|
NM and CM callable.
Moves a record from a disk file to a buffer in anticipation of a
FREADDIR intrinsic call.
Syntax
I16V I32V
FREADSEEK (filenum, lrecnum);
Parameters
- filenum
16-bit signed integer by value (required)
Passes the file number of the file to be read.
- lrecnum
32-bit signed integer by value (required)
Passes the relative number of the logical record to be read. A value of
zero indicates the first logical record.
Operation Notes
The FREADSEEK intrinsic enhances direct access of disk files. When a
certain record is required, use FREADSEEK before a call to
FREADDIR to transfer it to the stack. The FREADSEEK intrinsic
directs the operating system to move the record from disk into a buffer in
anticipation of the FREADDIR call, which moves the record directly to
the stack.
Issue the FREADSEEK intrinsic call only for direct-access files where
I/O buffering and fixed-length or undefined-length records are in effect.
FREADSEEK fails with a CCL condition code when filenum
references a NOBUF file. Byte stream files are opened NOBUF,
and not applicable to FREADSEEK intrinsic.
Not applicable to message files.
(KSAM) This intrinsic cannot be used for KSAM files. If called for a file
created as a KSAM file, CCL (1) is returned.
Condition Codes
CCE (2) | Request granted. |
CCG (0) | Request denied. A logical end-of-file indication was
encountered. |
CCL (1) | Request denied. An error occurred. |
Related Information
|