Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-25
UNLOCKREC Procedure
•
Unlocking several records
If several records need to be unlocked, the UNLOCKFILE procedure can be called
to unlock all records currently locked by the user (rather than unlocking the records
through individual calls to UNLOCKREC).
•
Current-state indicators after UNLOCKREC
For key-sequenced, relative, and entry-sequenced files, the current-state indicators
after an UNLOCKREC remain unchanged.
•
File pointers after UNLOCKREC
For unstructured files, the current-record pointer and the next-record pointer
remain unchanged.
•
Transaction Management Facility (TMF) and UNLOCKREC
A record that is locked in a file audited by TMF and has been modified by the
current transaction is unlocked when an ABORTTRANSACTION or
ENDTRANSACTION procedure is called for that file. Locks on modified records of
audited files are released only when the transaction is ended or aborted by TMF.
An unmodified audited record is unlocked by UNLOCKREC.
OSS Considerations
•
This procedure operates only on Guardian objects. If an OSS file is specified,
error 2 is returned
Example
CALL UNLOCKREC ( FILE^NUM );
Related Programming Manual
For programming information about the UNLOCKREC file-system procedure, refer to
the
Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.