Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-97
FILE_GETLOCKINFO_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation. Possible
error values include the following:
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.
2 The operation specified is not allowed on this type of file.
11 Lock information for the file, process, or 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, so any previously
returned information might be invalid. To start over, set
control to 0 and call
FILE_GETLOCKINFO_ again.
21 Invalid value specified for max-participants.
41 Checksum error on
control. The control parameter has been altered
between calls to FILE_GETLOCKINFO_ or was not initialized before the first
call.
45 Information for one locked record or file has been returned, but the
participants buffer was too small to hold all available information on lock
holders/waiters. More locks might exist, so continue calling
FILE_GETLOCKINFO_ (with
control unchanged).
error := FILE_GETLOCKINFO_ ( name:length ! i:i
,[ processhandle ] ! i
,[ transid ] ! i
,control ! i,o
,lock-descr ! o
,lock-descr-length ! i
,participants ! o
,max-participants ! i
,[ locked-name:maxlen ] ! o:i
,[ locked-name-length ] ); ! o