Guardian Procedure Calls Reference Manual

FILE_UNLOCKFILE64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manual
Summary
The FILE_UNLOCKFILE64_ procedure unlocks a disk file and any records in the file currently locked
by the user. The "user" is defined either as the opener of the file (identified by the filenum) if the
file is not audited—or the transaction (identified by the TRANSID) if the file is audited. Unlocking
a file allows other processes to access the file. It has no effect on an audited file that has been
modified by the current transaction.
FILE_UNLOCKFILE64_ extends the capabilities of UNLOCKFILE in the following ways:
• It is callable from both 32-bit and 64-bit processes.
• It allows a 64-bit nowait I/O tag to be passed.
• Rather than returning a condition code status, the procedure returns a file management error.
A return value of zero indicates success.
NOTE: The FILE_UNLOCKFILE64_ procedure is supported on systems running H06.24 and later
H-series RVUs and J06.13 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <cextdecs(FILE_UNLOCKFILE64_)>
short FILE_UNLOCKFILE64_ ( short filenum
,[ long long tag ] );
Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_UNLOCKFILE64_)
error := FILE_UNLOCKFILE64_ ( filenum ! i
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file to be unlocked.
518 Guardian Procedure Calls (F)