Guardian Procedure Calls Reference Manual

LOCKINFO Procedure (Superseded by FILE_GETLOCKINFO_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Structure Definitions for buffer
Considerations
OSS Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The LOCKINFO provides information about locks (held or pending) on a local DP2 disk volume.
Each call returns information about one lock, plus as many holders/waiters as the size of the
caller's buffer permits; successive calls can obtain information about all the locks for a volume,
file, process, or transaction.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
error := LOCKINFO ( searchtype ! i
,searchid ! i
,ctlwds ! i,o
,buffersize ! i
,buffer ); ! o
Parameters
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:
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.
0
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.
1
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
2
volume requested by the specified process. If the process ID of a named process is passed, the name
must be in uppercase characters.
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.
3
LOCKINFO Procedure (Superseded by FILE_GETLOCKINFO_ Procedure) 771