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

SPT_UNLOCKREC(2) OSS System Calls Reference Manual
Calling SPT_UNLOCKREC( ) after KEYPOSITION
If the call to SPT_UNLOCKREC( ) immediately follows a call to KEYPOSI-
TION where a nonunique alternate key is specified, the SPT_UNLOCKREC()
call fails. A subsequent call to FILE_GETINFO_ or FILEINFO shows that
Guardian file-system error 46 (invalid key) occurred. However, if an inter-
mediate call to SPT_READX( ) or SPT_READLOCKX() is performed, the call
to SPT_UNLOCKREC() is permitted.
Unlocking several records
If several records need to be unlocked, you can call the SPT_UNLOCKREC( )
function to unlock all records currently locked by the user (rather than unlocking
the records through individual calls to SPT_UNLOCKREC( )).
Current-state indicators after SPT_UNLOCKREC()
For key-sequenced, relative, and entry-sequenced files, the current-state indica-
tors after an UNLOCKREC remain unchanged.
File pointers after SPT_UNLOCKREC( )
For unstructured files, the current-record pointer and the next-record pointer
remain unchanged.
Transaction Management Facility (TMF) and SPT_UNLOCKREC( )
If the current transaction modifies a record in file audited by TMF, locks on the
record are released only when TMF ends or aborts the transaction. In other
words, a locked record in an audited file that the current transaction modified is
unlocked during SPT_ENDTRANSACTION() or
SPT_ABORTTRANSACTION() processing for that file. You can use the
SPT_UNLOCKREC() function to unlock an unmodified audited 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 SPT_UNLOCKREC() function returns 0 (zero) upon successful completion. Otherwise,
this function returns a nonzero Guardian file-system error number that indicates the outcome 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: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2),
SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_LOCKREC(2), SPT_READLOCKX(2),
SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2),
SPT_SETMODE(2), SPT_UNLOCKFILE(2), SPT_WRITEREADX(2),
SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEUPDATEX(2), SPT_WRITEX(2).
7−436 Hewlett-Packard Company 527186-023