Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-100
FILE_GETLOCKINFO_ Procedure
[2:5] The transid of the participant (if participants[0].<0> = 0).
max-participants input
INT:value
specifies the maximum number of lock holders and waiters that can be described
in the
participants buffer.
locked-name:maxlen output:input
STRING .EXT:ref:*, INT:value
if present and a volume name is supplied for
name, returns the subvolume and file
identifier (the two rightmost parts of the file name) of the file on which the lock is
set.
maxlen gives the length in bytes of the string variable locked-name.
locked-name-length output
INT .EXT:ref:1
returns the length in bytes of the value of
locked-name.
Considerations
•
The FILE_GETLOCKINFO_ procedure supports single SMF logical files but does
not support entire SMF virtual volumes. If the name of an SMF logical file is
supplied to this procedure, the system queries the disk process of the appropriate
physical volume to obtain information about current lock holders and lock waiters
on the file. If the name of an SMF virtual volume is supplied, but not a full logical
file name, an error is returned.
If you call the FILE_GETLOCKINFO_ procedure and supply the name of a physical
volume, lock information is returned for any file on that volume that is open under
an SMF logical file name, but the returned file name is that of the physical file
supporting the logical file.
•
A valid range for max-participants is 1-2548.
OSS Considerations
•
This procedure operates only on Guardian objects. OSS files cannot have
Guardian locks, so there is no information to be returned. If an OSS file is
specified, error 0, indicating no error, is returned.