Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-20
UNLOCKFILE Procedure
UNLOCKFILE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
OSS Considerations
Example
Related Programming Manual
Summary
The UNLOCKFILE procedure unlocks a disk file and any records in that file currently
locked by the user. The “user” is defined either as the opener of the file (identified by
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.
Syntax for C Programmers
•
CEXTDECS (via the included file TNSINTH) defines 32-bit values as the typedef
__int32_t which for TNS and TNS/R compiles is defined as
long and for TNS/E
compiles is defined as
int.
•
The function value returned by UNLOCKFILE, which indicates the condition code,
can be interpreted by
_status_lt(), _status_eq(), or _status_gt()
(defined in the file
tal.h).
Syntax for TAL Programmers
Parameters
filenum input
INT:value
is a number of an open file that identifies the file to be unlocked.
#include <cextdecs(UNLOCKFILE)>
_cc_status UNLOCKFILE ( short filenum
,__int32_t tag );
CALL UNLOCKFILE ( filenum ! i
,[ tag ] ); ! i