MPE/iX Intrinsics Reference Manual (32650-90875)

290 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FWRITEDIR
composed of fixed-length or undefined-length records.
When information is written to a fixed-length record and NOBUF is not specified in the
FOPEN/HPFOPEN call that opens the file, any unused portion of the record is padded with
binary zeros or ASCII blanks.
When the FWRITEDIR intrinsic is executed, the logical record pointer is set to the record
immediately following the record just written, or the first logical record of the next block
for NOBUF files.
If RIO access is used, the modified record is set to the ACTIVE state.
When an FWRITEDIR call writes a record beyond the current logical end-of-file indicator,
the indicator is advanced. This can result in the creation of dummy records to pad the
records between the previous end-of-file and the newly written record. When the new
record is in the same extent, these dummy records are filled with binary zeros or with
ASCII blanks.
When the physical bounds of the file prevent further writing because all allowable extents
are filled, the end-of-file condition (CCG (0)) is returned to the program.
Not applicable to message files.
(KSAM) This intrinsic cannot be used for KSAM files. If called for a file created as a KSAM
file, CCL (1) is returned.
Condition Codes
CCE (2) Request granted.
CCG (0) Request denied. The physical end-of-file was encountered.
CCL (1) Request denied. An error occurred.
Related Information
Manuals Accessing Files Programmer's Guide