Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-116
FILE_OPEN_ Procedure
options input
INT:value
specifies optional characteristics. The bits, when set to 1, indicate the following:
<0> 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.
<1> 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
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.
<2> 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.
<3> 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.
<4:9> Reserved (specify 0)
<10> Open an OSS file by its OSS pathname. Specifies that the file to be
opened is identified by the
pathname parameter.
<11> Reserved (specify 0)
<12> No transactions. For $RECEIVE, messages are not to include
transaction identifiers. Must be 0 if bit 15 is 1.
<13> I18N locale support. For $RECEIVE, data messages include
internationalization locale information. Must be 0 if bit 15 is 1. Refer to
the
Software Internationalization Guide for information about
internationalization.
<14> Old format system messages. For $RECEIVE, system messages
should 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.”
<15> 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 messages. If this bit is 0, messages are delivered as
normal; some messages are received only with SETMODE 80. (Note