MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 6 237
Command Definitions (FLUSHLOG-GETUSERMODE)
FOPEN
implies the inhibit buffering option ( aoption bit (7:1)); if NOBUF is not
specified, the file system does it for you and multirecord access is not
available. This option is not available if the file is located on a remote
computer. When opening nonmessage files, the process must be running in
privileged mode to specify this option.
The following bit settings are valid:
0 Nowait I/O not in effect
1 Nowait I/O in effect
Default: 0
Nowait I/O cannot be specified for directories.
3:1 Copy mode option
Determines whether a file should be treated as a standard sequential file
(copy by logical record) or physical block (copy to another file). Copy must
be set to obtain EXCLUSIVE access. This causes the multiaccess bits to be
set to 00. The following values are valid:
0 The file is accessed as its own file type.
1 The file is treated as a standard (STD) file, with
variable-length records. For message files, this allows
nondestructive reading of an old message file at either the
logical record or physical-block-record level. Only
block-level access is permitted if the file has message file
format. This prevents incorrectly formatted data from
being written to the message file while it is unprotected.
In order to access a message file in copy mode, a process
must be able to obtain EXCLUSIVE access to the file. If
opening the message file for read only, the file system tries
to grant exclusive access; for write only access to the
message file, the EXCLUSIVE bits (8:2) in the
aoptions
must be set to 01.
Default: 0
0:3 Reserved for the operating system.
recsize 16-bit signed integer by value (optional)
Passes the size, in half words or bytes, of the logical records in the file. If
recsize =0, the system uses the default record size, 256 bytes. Positive
values are half words; negative values are bytes. The valid range is
dependent on storage and record formats:
• For fixed-length and undefined-length ASCII files, the valid range is
1..32,767 bytes.
• For variable-length ASCII files and fixed-length, variable-length, and
undefined-length binary files, the range is 1..32,766 bytes (1..16,383
half words). All odd values specified are rounded up to the next even