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

PUT_FILE_OPEN_(2) OSS System Calls Reference Manual
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 (zero).
12 No transactions. For $RECEIVE, messages are not to include
transaction identifiers. This bit must be 0 (zero) if bit 15 is 1.
13 Internationalization locale support. For $RECEIVE, data mes-
sages include internationalization locale information. This bit
must be 0 (zero) if bit 15 is 1. For information about internation-
alization, see the Software Internationalization Guide.
14 Old-format system messages. For $RECEIVE, system messages
should be delivered in C-series format. If this bit is 0 (zero), D-
series format messages are delivered. For other device types,
this bit must be 0 (zero). See Interprocess Communication
Considerations in the DESCRIPTION subsection of this refer-
ence page.
15 No file-management system messages. For $RECEIVE,
specifies that the caller does not wish to receive process open,
process close, CONTROL, SETMODE, SETPARAM, RESET-
SYNC, and CONTROLBUF messages. If this bit is 0 (zero),
messages are delivered as normal; some messages are received
only with PUT_SETMODE(80). For other device types, this bit
must be 0 (zero).
When options is omitted, 0 (zero) is used for all bits.
seq_block_buffer_id
If present and not 0 (zero), identifies the buffer to be used for shared sequential
block buffering; all opens made through PUT_FILE_OPEN_() and using this
ID share the same buffer. You can supply any integer value for this parameter.
If seq_block_buffer_id is omitted or 0 (zero), and sequential block buffering is
requested, the buffer is not shared. In this case, the buffer resides in the
process’s process file segment (PFS) with the size given by
seq_block_buffer_len.
seq_block_buffer_len
Specifies whether sequential block buffering is being requested. If this parame-
ter is supplied with a value greater than 0 (zero), 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 (zero), 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.
5−202 Hewlett-Packard Company 527186-023