Guardian Procedure Calls Reference Manual

tag
input
INT(64):value
for nowait I/O only, is a value you define that uniquely identifies the operation associated
with this FILE_UNLOCKREC64_.
NOTE: The system stores the tag value until the I/O operation completes. It then returns the
tag information to the program in either the tag parameter of the call to FILE_AWAITIO64_
or the tag field of the completion-info parameter of the call to FILE_COMPLETEL_, thus
indicating that the operation finished.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• EpTAL callers must set toggle
EpTAL callers must set the toggle _64BIT_CALLS before sourcing the FILE_UNLOCKREC64_
section from EXTDECS.
• Familiar semantics
Unless otherwise described, the semantic behavior of FILE_UNLOCKREC64_ is the same as
that of UNLOCKREC.
• Nowait and FILE_UNLOCKREC64_
The FILE_UNLOCKREC64_ procedure must complete with a corresponding call to the
FILE_AWAITIO64_ or FILE_COMPLETEL_ procedure when used with a file that is opened
nowait.
• Queuing processes and FILE_UNLOCKREC64_
If any users are queued in the locking queue for the record, the user at the head of the locking
queue is granted access and is removed from the queue (the next read or lock request moves
to the head of the queue).
If the user granted access is waiting to lock the record, it is granted the lock (which excludes
other process from accessing the record) and resumes processing.
If the user granted access is waiting to read the record, its read is processed.
• Calling FILE_UNLOCKREC64_ after FILE_SETKEY_ (or KEYPOSITION[X])
If the call to FILE_UNLOCKREC64_ immediately follows a call to FILE_SETKEY_ (or
KEYPOSITION[X]) where a nonunique alternate key is specified, the FILE_UNLOCKREC64_
fails with an error 46 (invalid key). However, if an intermediate call to READ or READLOCK
is performed, the call to FILE_UNLOCKREC64_ is permitted.
• Unlocking several records
If several records need to be unlocked, FILE_UNLOCKREC64_ can be called to unlock all
records currently locked by the user (rather than unlocking the records through individual calls
to FILE_UNLOCKREC64_).
• Current-state indicators after FILE_UNLOCKREC64_
For key-sequenced, relative, and entry-sequenced files, the current-state indicators after a
FILE_UNLOCKREC64_ remain unchanged.
522 Guardian Procedure Calls (F)