Open System Services System Calls Reference Manual (G06.28+)

SPT_FILE_OPEN_(2) OSS System Calls Reference Manual
process pair Specifies whether or not an I/O operation is automatically
redirected to the backup process if the primary process or its
processor module fails. For processes, this parameter is called
sync depth. The maximum value is determined by the process.
The value must be at least 1 for an I/O operation to a remote pro-
cess pair to recover from a network failure. If this parameter
greater than or equal to 1, the server is expected to save or be
able to regenerate that number of replies. If this parameter is 0
(zero), and if an I/O operation cannot be performed to the pri-
mary process of a process pair, an error indication is returned to
the originator of the message. On a subsequent I/O operation,
the file system redirects the request to the backup process.
For other device types, the meaning of this parameter depends on whether the
sync-ID mechanism is supported by the device being opened. If the device does
not support the sync-ID mechanism, 0 (zero) is used regardless of what you
specify (this is the most common case). If the device supports the sync-ID
mechanism, specifying a nonzero value causes the results of that 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 the
FILE_GETINFOLIST_ procedure.
options Specifies optional characteristics as a bit mask. 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.) This bit must be
0 (zero) for other devices.
1 Nowait open processing. Specifies that the processing of the
open proceed in a nowait manner. Unless
SPT_FILE_OPEN_() returns an error, a nowait open must be
completed by a call to the Guardian AWAITIOX procedure.
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 con-
trolled 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. This bit must be 0 (zero)
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. A value of 0 (zero) specifies that the backup open
is to have the same file number as the primary open. Guardian
file-system error 12 is returned if that file number is already in
use.
7−138 Hewlett-Packard Company 527186-005