|
|
900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command DefinitionsFWRITEDIR |
|
NM and CM callable. Writes a specific logical record from the stack to a disk file.
This intrinsic differs from the FWRITE intrinsic, the FWRITE intrinsic writes only the record pointed to by the logical record pointer. Use the FWRITEDIR intrinsic only for disk files 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.
|
|