HPlogo Using KSAM XL and KSAM 64 > Chapter 9 KSAM Intrinsics

FPOINT

MPE documents

Complete PDF
Table of Contents
Index

E0300 Edition 4 ♥
E0394 Edition 3

Syntax Parameters Operation Notes Condition Codes

Sets the logical and physical record pointers to the specified record.

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 physical record number where the physical record pointer is to be positioned. Record numbering starts with zero or one, depending on how the file was created.

Operation Notes


This intrinsic does not read the advance flag. It positions both the logical record pointer and the physical pointer to the appropriate record. When its function is complete, it sets the advance flag to FALSE.

Condition Codes


CCE

Request granted.

CCG

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

CCL

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

  • Invalid filenum parameter.

  • The lrecnum parameter specified a record marked for deletion.

Refer to this intrinsic in the MPE/iX Intrinsics Reference Manual for other codes pertaining to KSAM files.




FOPEN


FREAD