Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-15
OPEN Procedure (Superseded by FILE_OPEN_
Procedure )
Parameters
file-name input
INT:ref:12
is an array containing the internal-format file name of the file to be opened. Refer
to Appendix D, File Names and Process Identifiers
for additional information about
file names.
Note that
file-name can be a DEFINE name. Refer to Appendix E, DEFINEs for
additional information about DEFINEs.
filenum output
INT:ref:1
returns a number used to identify the file in subsequent system calls. A -1 is
returned if OPEN fails.
flags input
INT:value
specifies certain attributes of the file. If omitted, all fields are set to 0. The bit fields
in the
flags parameter are defined in Table 11-2.
sync-or-receive-depth input
INT:value
The purpose of this parameter depends on the type of device being opened:
Disk file specifies the number of nonretryable (that is, write) requests whose
completion the file system must remember. A value of one or greater
must be specified to recover from a path failure occurring during a write
operation. This value also implies the number of write operations the
primary process in a primary and backup process pair can perform to
this file without intervening checkpoints to its backup process. For disk
files, this parameter is called sync depth. The maximum sync depth
value is 15.
If omitted, or if 0 is specified, internal checkpointing does not occur.
Disk path failures are not automatically retried by the file system.
$RECEIVE file
specifies the maximum number of incoming messages read by
READUPDATE that the application process is allowed to queue before
corresponding REPLYs must be performed.
If omitted, READUPDATE and REPLY to $RECEIVE are not permitted.
For $RECEIVE, this parameter is called receive depth, and the
maximum number of queued incoming messages is 4047.