Guardian Procedure Calls Reference Manual

number of operations to be saved; in case of path failures, the operations are retried
automatically.
The actual value being used can be obtained by a call to FILE_GETINFOLIST_.
options
input
INT:value
specifies optional characteristics. The bits, when set to 1, indicate:
Unstructured access. For disk files, access is to occur as if the file were unstructured, that is, without regard
to record structures and partitioning. (For unstructured files, setting this bit to 1 causes secondary partitions
to be inaccessible.) Must be 0 for other devices.
<0>
Nowait open processing. Specifies that the processing of the open proceed in a nowait manner. Unless
FILE_OPEN_ returns an error, a nowait open must be completed by a call to AWAITIO[X]. This option
<1>
cannot be specified for the Transaction Monitoring Facility (TMF) transaction pseudofile (TFILE). This option
does not determine the nowait mode of I/O operations; that is controlled by the nowait-depth
parameter. nowait-depth must have a nonzero value when this option is used.
No open time update. For disk files, the "time of last open" file attribute is not updated by this open.
Must be 0 for other devices.
<2>
Any file number for backup open. When performing a backup open, specifies that the system can use
any file number for the backup open. 0 specifies that the backup open is to have the same file number
as the primary open. Error 12 is returned if that file number is already in use.
<3>
Reserved (specify 0).<4:9>
Open an OSS file by its OSS pathname. Specifies that the file to be opened is identified by the pathname
parameter.
<10>
Reserved (specify 0).<11>
No transactions. For $RECEIVE, messages are not to include transaction identifiers. Must be 0 if bit 15
is 1.
<12>
I18N locale support. For $RECEIVE, data messages include internationalization locale information. Must
be 0 if bit 15 is 1. For information about internationalization, see the Software Internationalization Guide.
<13>
Old format system messages. For $RECEIVE, system messages must be delivered in C-series format. If
this bit is 0, D-series format messages are delivered. For other device types, this bit must be 0. See
Interprocess Communication Considerations (page 468).
<14>
No file-management system messages. For $RECEIVE, specifies that the caller does not wish to receive
process open, process close, CONTROL, SETMODE, SETPARAM, RESETSYNC, and CONTROLBUF
<15>
messages. If this bit is 0, messages are delivered as normal; some messages are received only with
SETMODE function 80. (Note that the meaning of this flag is opposite from that of the equivalent flag in
the OPEN procedure). For other device types, this bit must be 0.
When options is omitted, 0 is used.
seq-block-buffer-id
input
INT:value
if present and not 0, identifies the buffer to be used for shared sequential block buffering; all
opens made through FILE_OPEN_ and using this ID share the same buffer. Any integer value
can be supplied for this parameter.
If seq-block-buffer-id is omitted or 0, and sequential block buffering is requested, the
buffer is not shared. In this case, the buffer resides in the process' process file segment (PFS)
with the size given by seq-block-buffer-len.
460 Guardian Procedure Calls (F)