The $ZGETLKI function returns an item of information about a VMS lock.
The format for the $ZGETLKI() function is:
$ZGETLKI(expr1,expr2)
The first expression specifies a lock-id identifying the target VMS lock.
The second expression specifies the item keyword identifying the type of information returned; keywords may be in upper-, lower-, or mixed-case.
$ZGETLKI() provides a tool for examining VMS lock characteristics from within M. Accessing information about locks belonging to other users requires WORLD or SYSLCK privileges. Note that VMS locks and M LOCKs are not at all the same, even though they serve corresponding purposes in their respective environments. For information about VMS locks, refer to the VMS Introduction to System Services.
|
$ZGETLKI() Item Keywords |
|
|
ITEM KEYWORD |
$ZGETLKI() DATA RETURNED |
|
CSID CVTCOUNT GRANTCOUNT LCKREFCNT |
Cluster system ID of the system where the process owning the VMS lock resides Number of VMS locks on the conversion queue for the lock resource Number of VMS locks on the grant queue for the lock resource Number of locks having this VMS lock as a parent |
|
LKID LOCKID MSTCSID MSTLKID |
Lock ID of the lock on the node where the process owning the lock resides Lock ID of the lock Cluster system ID of the node currently mastering the lock resource Lock ID of the master copy of the lock |
|
NAMSPACE PARENT PID RESNAME |
Resource name space information Lock ID of the parent lock for the lock PID of the process owning the lock Lock resource name as a string |
|
RSBREFCNT STATE VALBLK WAITCOUNT |
Number of sub-resource of the lock resource Current state of the lock Lock value block of the resource; formatted as a string of 32 hexadecimal digits Number of locks on the wait queue for the resource of the lock |