Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-16
LOCKINFO Procedure
(Superseded by FILE_GETLOCKINFO_ Procedure )
searchtype input
INT:value
indicates the type of lock search that is desired (see the
searchid parameter for
more details on search options).
Valid values and their uses are:
0 Return lock information for volume
searchid. A valid DP2 disk volume name
must be placed in
searchid[0:3]. Successive calls will eventually return
information for all locks on that volume.
1 Return lock information for file
searchid. A valid file name must be passed
in
searchid[0:11]. Successive calls will eventually return information for
all locks on the identified file.
2 Return information on locks for volume
searchid[0:3], requested by the
process identified by the process ID in
searchid[4:7]. Successive calls
will eventually return information for all locks on the specified volume
requested by the specified process. If the process ID of a named process is
passed, the name must be in uppercase characters.
3 Return information on locks for volume
searchid[0:3], requested by the
TMF transaction identified by a transid in
searchid words [4:7]. Successive
calls will eventually return information for all locks on the specified volume
requested by the specified transaction.
searchid input
INT .EXT:ref:12
identifies the volume, file, volume and process, or volume and transaction for
which information is to be returned. Words [0:3] of
searchid must always contain
the name of the local DP2 disk volume that is to be searched. For the four
different values of
searchtype, the following formats apply:
ctlwds input, output
INT .EXT:ref:4
provides information needed by the file system to return successive pieces of lock
information over a sequence of calls.
On input,
ctlwds must be set to zeros before calling LOCKINFO for the first time
for one combination of
searchtype/searchid. On all subsequent calls, ctlwds
searchtype [ 0:3 ] [ 4:7 ] [ 8:11 ]
0 volume ignored ignored
1 volume subvolume file ID
2 volume process ID ignored
3 volume TRANSID ignored