HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

FREADSEEK

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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)

Feedback to webmaster