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

FPOINT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

NM and CM callable.

Sets the logical record pointer for a disk file containing fixed-length or undefined-length records to any logical record. When the next FREAD or FWRITE file request is made, this record is read or written to.

(KSAM) Sets both the chronological and logical record pointers to the next record in chronological sequence (the order records were written to the file).

Syntax

             I16V    I32V

   FPOINT(filenum,lrecnum);

Parameters

filenum

16-bit signed integer by value (required)

Passes the file number of the file where the pointer is to be set.

lrecnum

32-bit signed integer by value (required)

Passes the relative logical record (or block number for a NOBUF file) where the logical record pointer is to be positioned. The number of the first logical record is 0.

On disk files, the EOF indicator is the file limit.

If the filenum parameter refers to a byte stream file, the lrecnum parameter is interpreted as a byte offset to which the file pointer is set.

(KSAM) For fixed-length files, record numbering starts with 0 or 1, depending on how the file was created.

(KSAM/3000) For KSAM/3000 files with variable-length records, the number of the first logical record is 0.

Condition Codes

CCE (2)

Request granted.

CCG (0)

Request denied. The logical record pointer position is unchanged. Positioning was requested at a point beyond the file limit.

CCL (1)

Request denied. The logical record pointer position is unchanged because of one of the following:

  • Lrecnum <0

  • Invalid filenum parameter

  • I/O is pending on a nowait request

  • Spooled file

  • Not a direct access disk file

  • File does not contain fixed-length or undefined-length records

  • Not allowed with append access

(KSAM) The filenum parameter was invalid or lrecnum specified a record marked for deletion.

Operation Notes

Not applicable to message files.

Related Information

Intrinsics

None

Commands

None

Manual

Accessing Files Programmer's Guide (32650-90017), Using KSAM XL (32650-90168), and KSAM/3000 Reference Manual (30000-90079)

Feedback to webmaster