MPE/iX Intrinsics Reference Manual (32650-90905)

250 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FPOINT
FPOINT
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