Guardian Procedure Calls Reference Manual

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, these formats
apply:
[ 8:11 ][ 4:7 ][ 0:3 ]searchtype
ignoredignoredvolume0
file IDsubvolumevolume1
ignoredprocess IDvolume2
ignoredTRANSIDvolume3
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 must be passed
to LOCKINFO as previously returned. If it is modified in any way, error 41 may be returned.
On output, ctlwds returns the information LOCKINFO needs for the next call. These four
words must be passed exactly as they were returned on the previous call to LOCKINFO.
buffersize
input
INT:value
indicates the size, in bytes, of the buffer available for returned lock information. The minimum
value is 304. The size of the buffer determines how much information can be returned on each
LOCKINFO call.
buffer
output
STRING .EXT:ref:*
specifies the buffer in which LOCKINFO will place the lock information. The structure of the
information returned in buffer is described under Structure Definitions for buffer.
Returned Value
INT
A file-system error code that indicates the outcome of the call:
Information for one locked resource and all its accessors was returned without error. More locks may exist;
continue calling LOCKINFO.
00
End of lock information for searchtype/searchid.01
Invalid searchtype (not 0, 1, 2, or 3).02
Lock information for the file, process, or transaction in searchid was not found. If any information has been
returned already, it is now invalid.
11
The lock tables in DP2 were changed between calls, so any previously returned information may be invalid.
To start over, set ctlwds to zero and call LOCKINFO again
12
772 Guardian Procedure Calls (L)