HPlogo MPE/iX Intrinsics Reference Manual > Chapter 6 Command Definitions (FLUSHLOG-GETUSERMODE)

FPOINT

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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 FSPACE
Manuals Accessing Files Programmer's Guide
Using KSAM XL
KSAM/3000 Reference Manual




FPARSE


FREAD