Guardian Procedure Calls Reference Manual

FILE_UNLOCKREC64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manual
Summary
The FILE_UNLOCKREC64_ procedure unlocks a record 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. FILE_UNLOCKREC64_ unlocks the
record at the current position, allowing other users to access that record. FILE_UNLOCKREC64_
has no effect on a record of an audited file if that record has been modified by the current
transaction.
FILE_UNLOCKREC64_ extends the capabilities of UNLOCKREC 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_UNLOCKREC64_ 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_UNLOCKREC64_)>
short FILE_UNLOCKREC64_ ( short filenum
,[ long long tag ] );
Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_UNLOCKREC64_)
error := FILE_UNLOCKREC64_ ( filenum ! i
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file containing the record to be unlocked.
FILE_UNLOCKREC64_ Procedure 521