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

System Functions (n - p) PUT_UNLOCKFILE(2)
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
Considerations
Nowait and PUT_UNLOCKFILE()
The PUT_UNLOCKFILE() function must complete with a corresponding call
to the Guardian AWAITIOX procedure when used with a file that is opened for
nowait I/O.
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 lock-
ing queue is waiting to:
• lock the file or lock a record in the file, the user is granted the lock
(which excludes other users from accessing the file) and resumes pro-
cessing.
• read the file, its read is processed.
Transaction Management Facility (TMF) and PUT_UNLOCKFILE()
If the current transaction modifies a file audited by TMF, locks on the file are
released only when TMF ends or aborts the transaction. In other words, a locked
audited file that the current transaction modified is unlocked during
PUT_ENDTRANSACTION() or PUT_ABORTTRANSACTION() process-
ing for that file. You can use the PUT_UNLOCKFILE() function to unlock an
unmodified audited record.
Use on OSS Objects
This procedure operates only on Guardian objects. If an OSS file is specified, Guardian file-
system error 2 occurs.
RETURN VALUES
The PUT_UNLOCKFILE() function returns 0 (zero) upon successful completion. Otherwise,
this function returns a nonzero Guardian file-system error number that indicates the outcome of
the operation.
For information about Guardian file-system error numbers, see the Guardian Procedure Errors
and Messages Manual.
ERRORS
None. This function does not set the errno variable.
RELATED INFORMATION
Functions: PUT_CANCEL(2), PUT_CONTROL(2), PUT_FILE_CLOSE_(2),
PUT_FILE_OPEN_(2), PUT_LOCKFILE(2), PUT_LOCKREC(2),
PUT_READLOCKX(2), PUT_READUPDATELOCKX(2), PUT_READUPDATEX(2),
PUT_READX(2), PUT_SETMODE(2), PUT_UNLOCKREC(2), PUT_WRITEREADX(2),
PUT_WRITEUPDATEUNLOCKX(2), PUT_WRITEUPDATEX(2), PUT_WRITEX(2).
527186-023 Hewlett-Packard Company 5−287