HP 3000 Manuals HP 3000 Manuals
FREADSEEK
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
Intrinsics None
Commands None
Manuals Accessing Files Programmer's Guide (32650-90017)