HP 3000 Manuals HP 3000 Manuals
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
* 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)