MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 6 265
Command Definitions (FLUSHLOG-GETUSERMODE)
FREADSEEK
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
Manuals Accessing Files Programmer's Guide