TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-170
#FILEGETLOCKINFO Built-In Function
If #FILEGETLOCKINFO is called to find locks on a disk volume and the status code is
0 (no error) or 45 (warning; there were more lock holders or waiters than would fit into
the participants structure), the status number is followed by a space and the name of
the locked file. The file name is in the form subvolume.file, without a node name or
volume name.
Considerations
•
#FILEGETLOCKINFO replaces #LOCKINFO for D-series operating systems.
Existing #LOCKINFO calls should be converted to #FILEGETLOCKINFO calls for
D-series use.
•
A file or record can have one granted lock and several pending locks. Each call to
#FILEGETLOCKINFO returns information about one lock and as many holders or
waiters as permitted by the size of your participants STRUCT. To obtain
information on all locks on a file or volume, make successive calls to
#FILEGETLOCKINFO until the returned status code equals 1. On each call, the file
system updates the control STRUCT and keeps track of information for the next
call.
•
#FILEGETLOCKINFO uses the D-series FILE_GETLOCKINFO_ procedure.
•
When key size in the user specified lockdesc structure is 256 and the actual lock
information size of file or volume is greater than the user specified lockdesc
structure size, then TACL returns error -2. In this case, change the key size as
0:2047.
-1 The control STRUCT is the wrong size.
-2 The lockdesc STRUCT is the wrong size.
-3 The participants STRUCT is the wrong size. (This STRUCT can vary in
size, but it must always be a multiple of the size that would be required for
one participant.)
Table 9-10. #FILEGETLOCKINFO Status Codes
Code Meaning