Guardian Procedure Calls Reference Manual

to RBA-2. Depending on the process' locking mode, the call either fails with file-system
error 73 ("record is locked") or is placed in the locking queue.
◦ Record pointers after FILE_LOCKREC64_
After a call to FILE_LOCKREC64_, the current-record, next-record, and end-of-file pointers
remain unchanged.
• Avoiding or resolving deadlocks
One way to avoid deadlock is to use one of the alternate locking modes that can be established
by function 4 of the FILE_SETMODENOWAIT64_ procedure. A common method of avoiding
deadlock situations is to lock records in some predetermined order. Deadlocks can be resolved
if you lock records using a nowait open and call FILE_AWAITIO64_ with a timeout specified.
OSS Considerations
This procedure operates only on Guardian objects. If an OSS file is specified, error 2 occurs.
Related Programming Manual
For programming information about the FILE_LOCKREC64_ procedure, see the Enscribe
Programmer's Guide and the Guardian Programmer's Guide.
456 Guardian Procedure Calls (F)