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

PUT_READUPDATEX(2) OSS System Calls Reference Manual
Calling PUT_READUPDATEX( ) after PUT_READX()
A call to PUT_READUPDATEX() after a call to PUT_READX(), without
intermediate positioning, returns the same record as the call to PUT_READX().
Waited PUT_READUPDATEX()
If a waited PUT_READUPDATEX() call is executed, the count_read parame-
ter indicates the number of bytes actually read.
Nowait I/O and PUT_READUPDATEX()
If a nowait PUT_READUPDATEX() call is executed, count_read has no mean-
ing and can be omitted. The count of the number of bytes read is obtained when
the I/O operation completes through the c ount_transferred parameter of the
Guardian AWAITIOX procedure. The PUT_READUPDATEX() function must
complete with a corresponding call to the Guardian AWAITIOX procedure when
used with a file that is opened for nowait I/O.
Default locking mode action
If the default locking mode is in effect when a call to PUT_READUPDATEX()
is made to a locked file or record, but the filenum of the locked file differs from
the filenum in the call, the caller of PUT_READUPDATEX() is suspended and
queued in the locking queue behind other processes attempting to access the file
or record.
Use on OSS objects
This procedure operates only on Guardian objects. If an OSS file is specified, Guardian file-
system error 2 occurs.
RETURN VALUES
The PUT_READUPDATEX() function returns 0 (zero) upon successful completion. Other-
wise, this function returns a nonzero Guardian file-system error number that indicates the out-
come of the operation.
For information about Guardian file-system error numbers, see the Guardian Procedure Errors
and Messages Manual.
ERRORS
None. This function does not set the errno variable.
RELATED INFORMATION
Functions: PUT_CANCEL(2), PUT_CONTROL(2), PUT_FILE_CLOSE_(2),
PUT_FILE_OPEN_(2), PUT_LOCKFILE(2), PUT_LOCKREC(2),
PUT_READLOCKX(2), PUT_READUPDATELOCKX(2), PUT_READX(2),
PUT_SETMODE(2), PUT_UNLOCKFILE(2), PUT_UNLOCKREC(2),
PUT_WRITEREADX(2), PUT_WRITEUPDATEUNLOCKX(2),
PUT_WRITEUPDATEX(2), PUT_WRITEX(2).
5−242 Hewlett-Packard Company 527186-023