Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-38
FILE_GETLOCKINFO_
Obtains information about locks (held or pending) on a local disk file or on a set of files
on a local disk volume. This procedure operates only on Guardian objects.
error := FILE_GETLOCKINFO_ ( name:length
,[ processhandle ]
,[ transid ]
,control
,lock-descr
,lock-descr-length
,participants
,max-participants
,[ locked-name:maxlen ]
,[ locked-name-length ] );
error, INT returned value
0 Information for one locked file and all its lock holders/waiters was returned
without error. More locks might exist; continue calling FILE_GETLOCKINFO_.
1 End of information about locks associated with a process or transID.
11 Lock information for the file processor transaction was not found. If any
information has been returned already, it is now invalid.
12 The disk-process lock tables were changed between calls.
41 Checksum error on control. The control parameter has been altered between
calls to FILE_GETLOCKINFO_, or it was not initialized before the first call.
45 Information for one locked record or file has been returned
name:length, STRING .EXT:ref:*,INT:value input:input
processhandle, INT .EXT:ref:10 input
transid, INT .EXT:ref:4 input
control, INT .EXT:ref:10 input, output
lock-descr, INT .EXT:ref:* output
[0] Lock type. 0 indicates a file lock; 1 indicates a record lock.
[1] Flags. The bits are:
<0> = 1 indicates a generic lock.
<1:15> = Reserved.
[2] The number of participants (the number of holders and waiters for the
lock).