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_UNLOCKFILE64_.
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_UNLOCKFILE64_
procedure section from EXTDECS.
• Familiar semantics
Unless otherwise described, the semantic behavior of FILE_UNLOCKFILE64_ is the same as
that of UNLOCKFILE.
• Nowait and UNLOCKFILE
The FILE_UNLOCKFILE64_ procedure must complete with a corresponding call to the
FILE_AWAITIO64_ or FILE_COMPLETEl_ procedure when used with a file that is opened
nowait.
• Locking queue
If any users are queued in the locking queue for the file, the process 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 next user in the locking queue is waiting to:
lock the file or lock a record in the file, it is granted the lock (which excludes other users
from accessing the file) and resumes processing.
◦
◦ read the file, its read is processed.
• Transaction Management Facility (TMF) and FILE_UNLOCKFILE64_
Locks on a file audited by TMF which has been modified by the current transaction are released
only when the transaction is ended or aborted by TMF; in other words, a locked audited file
which has been modified by the current transaction is unlocked during an ENDTRANSACTION
or ABORTTRANSACTION processing for that file. An unmodified audited file is unlocked by
FILE_UNLOCKFILE64_.
OSS Considerations
This procedure operates only on Guardian objects. If an OSS file is specified, error 2 is returned.
Example
ERROR := FILE_UNLOCKFILE64_ ( SAVE^FILENUM );
FILE_UNLOCKFILE64_ Procedure 519