Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (s and S) SPT_FILE_OPEN_(2)
process pair Specifies whether 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 process determines the maximum value. The value must be
at least 1 for an I/O operation to a remote process pair to recover
from a network failure. If this parameter is 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 primary process of a pro-
cess 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:
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 proceeds 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 TMF transaction
pseudofile (TFILE). This option does not determine the nowait
mode of I/O operations. The nowait_depth parameter, which
controls the nowait mode of I/O operations, must have a nonzero
value when you use this option.
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.
4 through 9 Reserved; specify 0 (zero).
527186-023 Hewlett-Packard Company 7−193