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

System Functions (n - p) PUT_WRITEX(2)
to 4KB, which is the default. Transfer sizes over 4KB are not supported in
default mode for unstructured access to structured files.
Large data transfers using PUT_SETMODE(141)
You can use PUT_SETMODE() function 141 to enable large data transfers
(more than 4096 bytes) for files opened with unstructured access, regardless of
unstructured buffer size. When you use PUT_SETMODE(141) to enable large
data transfers, you can to specify up to 56K (57344) bytes for the write _count
parameter. See the description of SETMODE functions in the Guardian Pro-
cedure Calls Reference Manual.
File is locked
If you call PUT_WRITEX() is made and the file is locked through a file number
other than that supplied in the call, the call is rejected with Guardian file-system
error 73 (file is locked).
Inserting a new record into a file
The PUT_WRITEX() function inserts a new record into a file in the position
designated by the file’s primary key:
Key-sequenced files
The record is inserted in the position indicated by the value in its
primary-key field.
Queue files The record is inserted into a file at a unique location. The disk
process sets the timestamp field in the key, which causes the
record to be positioned after the other existing records that have
the same high-order user key.
If the file is audited, the record is available for read operations
when the transaction associated with the write operation com-
mits. If the transaction aborts, the record is never available to
read operations. If the file is not audited, the record is available
as soon as the write operation finishes successfully. Unlike
other key-sequenced files, a write operation to a queue file will
never encounter a Guardian file-system error 10 (duplicate
record) because all queue file records have unique keys gen-
erated for them.
Relative files After an open or an explicit positioning by its primary key, the
record is inserted in the designated position.
Subsequent PUT_WRITEX() calls without intermediate posi-
tioning insert records in successive record positions. If -2 is
specified in a preceding positioning, the record is inserted in an
available record position in the file.
If -1 is specified in a preceding positioning, the record is inserted
following the last position used in the file. An existing record
does not have to be in that position at the time of the
PUT_WRITEX() call.
Entry-sequenced files
The record is inserted following the last record currently exist-
ing in the file.
527186-023 Hewlett-Packard Company 5−313