MPE/iX Intrinsics Reference Manual (32650-90875)

262 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FREADDIR
active and inactive records.) If an RIO file is accessed using the non-RIO method (NOBUF),
FREADDIR inputs the specified block.
After the FREADDIR intrinsic is executed, the logical record pointer is set to the beginning
of the next logical record, or the first logical record of the next block for NOBUF files.
It is possible to skip portions of records inadvertently, if the multirecord
aoption of
FOPEN/HPFOPEN is set and the
length parameter specified is greater than one logical
record. For example, if all of record 11 and half of record 12 is read in a file, the logical
record pointer is set to the beginning of record 13 after the FREADDIR intrinsic executes;
the second half of record 12 is skipped.
Byte stream files are applicable with FREADDIR intrinsic. The
lrecnum parameter specifies
a byte offset in the byte stream file, which is equivalent to a logical record number, since
the record size is one byte.
Not applicable to message files.
Condition Codes
CCE (2) Request granted. The information was read.
CCG (0) Request denied. End-of-file was encountered.
CCL (1) Request denied. The information was not read; an error occurred.
Related Information
Manuals Accessing Files Programmer's Guide, Using KSAM XL, and KSAM/3000
Reference Manual