Guardian Procedure Calls Reference Manual

seq-block-buffer-len
input
INT:value
specifies whether sequential block buffering is being requested. If this parameter is supplied
with a value greater than 0, it indicates a request for sequential block buffering and specifies
the length in bytes of the sequential block buffer. If this parameter is omitted or 0, sequential
block buffering is not requested. Sequential block buffering is only for disk files.
If this value is less than the data-block length that was given to this file or to any associated
alternate-key file, the larger value is used. Supplying a nonzero value for this parameter causes
a buffer to be allocated unless an existing buffer is to be shared (see the
seq-block-buffer-id parameter). If an existing buffer is to be shared, but it is smaller
than seq-block-buffer-len, sequential block buffering is not provided and a warning
value of 5 is returned.
primary-processhandle
input
INT .EXT:ref:10
indicates that the caller is requesting a backup open and specifies the process handle of the
primary process that already has the file open when its backup attempts to open the file. If this
parameter is supplied and not null (a null process handle has -1 in each word), filenum must
contain the filenum value that was returned to the primary. If a null process handle is supplied,
or the parameter is omitted, a normal open is being requested.
This option is used only when the backup process is the caller. It is more common for the primary
to perform this operation by a call to FILE_OPEN_CHKPT_.
elections
input
INT (32) :value, input
specifies these options:
Reserved (specify 0).<0:30>
Use 64-bit primary keys. For disk files only, bit <31> specifies that 64- bit primary-key values are used
instead of 32-bit values for unstructured, relative, or entry-sequenced files. Bit <31> is ignored for
<31>
key-sequenced files and nondisk devices. The elections parameter can be used with both Enscribe
format 1, Enscribe format 2, and OSS files.
If omitted, 0 is used.
Returned Value
INT
A file-system error code that indicates the outcome of the call. Some values are warnings (that is,
they indicate conditions that do not prevent the file from being opened); see the filenum
parameter, for determining whether the file was opened successfully.
General Considerations
• File numbers
File numbers are unique within a process. The lowest file number is 0 and is reserved for
$RECEIVE; the remaining file numbers start at 1. The lowest available file number is always
FILE_OPEN_ Procedure 461