Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

PUT_UNLOCKFILE(2) OSS System Calls Reference Manual
NAME
PUT_UNLOCKFILE - Unlocks a disk file and any records in that file currently locked by the
user
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
[#include <cextdecs.h>]
#include <pthread.h>
short PUT_UNLOCKFILE(
short filenum,
long tag);
PARAMETERS
filenum Specifies the Guardian file number of a Guardian file open instance for the file
that you want unlocked.
tag (Optional) For nowait I/O only. The tag value you define uniquely identifies the
operation associated with this call.
This parameter is supported only for program compatibility; if you provide it, it
is ignored.
DESCRIPTION
The PUT_UNLOCKFILE() function is a thread-aware version of the Guardian UNLOCKFILE
procedure.
The PUT_UNLOCKFILE() function 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 the filenum
value used) if the file is not audited, or by the transaction (identified by the TRANSID) if the file
is audited. Unlocking a file allows other processes to access the file. This call has no affect on
an audited file if the current transaction has modified that file.
For programming information about the Guardian UNLOCKFILE file-system procedure, see the
Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.
To use this function on systems running H06.21 or later RVUs or J06.10 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, perform the same tasks (described above) used to enable the function on systems
running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
5−286 Hewlett-Packard Company 527186-023