HP OpenVMS System Analysis Tools Manual


Previous Contents Index


SHOW LOCKS

Displays information about all lock management locks in the system, or about a specified lock.

Format

SHOW LOCKS [ lock-id
| /ADDRESS=n
| /ALL (d)
| /BRIEF
| /BLOCKING
| /CACHED
| /CONVERT
| /GRANTED


| /NAME=name
| /STATUS=(keyword[,...])
| /WAITING ] or SHOW LOCKS {/POOL | /SUMMARY}


Parameter

lock-id

Name of a specific lock.

Qualifiers

/ADDRESS=n

Displays a specific lock, given the address of the lock block.

/ALL

Lists all locks that exist in the system. This is the default behavior of the SHOW LOCKS command.

/BLOCKING

Displays only the locks that have a blocking AST specified or attached.

/BRIEF

Displays a single line of information for each lock.

/CACHED

Displays locks that are no longer valid. The memory for these locks is saved so that later requests for locks can use them. Cached locks are not displayed in the other SHOW LOCKS commands.

/CONVERT

Displays only the locks that are on the conversion queue.

/GRANTED

Displays only the locks that are on the granted queue.

/NAME=name

Displays all locks on the specified resource. Name can be the actual name of the resource, if it only contains uppercase letters, numerals, the underscore (_), dollar sign, colon (:), and some other printable characters, as for example, /NAME=MY_LOCK. If it contains other printable characters (including lowercase letters), you may need to enclose the name in quotation marks (""), as for example, /NAME="My_Lock/47". If it contains nonprintable characters, you can specify the name as a comma-separated list comprised of strings and hexadecimal numbers. For example, /NAME=("My_Lock",0C00,"/47") would specify the name "My_Lock<NUL><FF>/47". The hexadecimal number can be no more than 8 digits (4 bytes) in length. Nonprintable sequences of more than 4 bytes must be split into multiple hexadecimal numbers. The maximum length of a resource name is 32 characters.

/POOL

Displays the lock manager's poolzone information, which contains the lock blocks (LKB) and resource blocks (RSB).

/STATUS=(keyword[,...])

Displays only the locks that have the specified status bits set in the LKB$L_STATUS field. If you specify only one keyword, you can omit the parentheses. Status keywords are as follows:
Keyword Meaning
2PC_IP Indicates a two-phase operation in progress
2PC_PEND Indicates a two-phase operation pending
ASYNC Completes request asynchronously
BLKASTFLG Specifies a blocking AST
BLKASTQED Indicates a blocking AST is queued
BRL Indicates a byte range lock
CACHED Indicates a lock block in cache
CVTSUBRNG Indicates a sub-range convert request
CVTTOSYS Converts back to system-owned lock
DBLKAST Delivers a blocking AST
DCPLAST Delivers a completion AST
DPC Indicates a delete pending cache lock
FLOCK Indicates a fork lock
GRSUBRNG Grants sub-range lock
IP Indicates operation in process
MSTCPY Indicates a lock block is a master copy
NEWSUBRNG Indicates a new sub-range request
NOQUOTA Does not charge quota
PCACHED Indicates lock block needs to be cached
PROTECT Indicates a protected lock
RESEND Resends during failover
RM_RBRQD Requires remaster rebuild
RNGBLK Specifies a range block
RNGCHG Indicates a changing range
TIMOUTQ Indicates lock block is on timeout queue
VALBLKRD Indicates read access to lock value block
VALBLKWRT Indicates write access to lock value block
WASSYSOWN Indicates was system-owned lock

/SUMMARY

Displays summary data and performance counters.

/WAITING

Displays only the waiting locks.

Description

The SHOW LOCKS command displays the information described in Table 4-7 for each lock management lock in the system, or for the lock indicated by lock-id, an address or name. (Use the SHOW SPINLOCKS command to display information about spinlocks.) You can obtain a similar display for the locks owned by a specific process by issuing the appropriate SHOW PROCESS/LOCKS command. See the HP OpenVMS Programming Concepts Manual for additional information.

You can display information about the resource to which a lock is queued by issuing the SHOW RESOURCES command specifying the resource's lock-id.

Table 4-7 Contents of the SHOW LOCKS and SHOW PROCESS/LOCKS Displays
Display Element Description
Process Index 1 Index in the PCB array to a pointer to the process control block (PCB) of the process that owns the lock.
Name 1 Name of the process that owns the lock.
Extended PID 1 Clusterwide identification of the process that owns the lock.
Lock ID Identification of the lock.
PID Systemwide identification of the lock.
Flags Information specified in the request for the lock.
Par. ID Identification of the lock's parent lock.
Sublocks Count of the locks that the lock owns.
LKB Address of the lock block (LKB). If a blocking AST has been enabled for this lock, the notation "BLKAST" appears next to the LKB address.
Priority The lock priority.
Granted at Lock mode at which the lock was granted.
RSB Address of the resource block.
Resource Dump of the resource name. The two leftmost columns of the dump show its contents as hexadecimal values, the least significant byte being represented by the rightmost two digits. The rightmost column represents its contents as ASCII text, the least significant byte being represented by the leftmost character.
Status Status of the lock, information used internally by the lock manager.
Length Length of the resource name.
Mode Processor access mode of the namespace in which the resource block (RSB) associated with the lock resides.
Owner Owner of the resource. Certain resources owned by the operating system list "System" as the owner. Resources owned by a group have the number (in octal) of the owning group in this field.
Copy Indication of whether the lock is mastered on the local system or is a process copy.


1This display element is produced only by the SHOW PROCESS/LOCKS command.


Examples

#1

SDA>  SHOW LOCKS
Lock Database 
------------- 
 
Lock id:  3E000002            PID:    00000000   Flags: CONVERT NOQUEUE SYNCSTS 
Par. id:  00000000            SUBLCKs:       0          NOQUOTA CVTSYS 
LKB:      FFFFFFFF.7DF48150   BLKAST: 81107278 
Priority:     0000 
 
Granted at    CR   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF68D50 
Resource:          494D6224 42313146  F11B$bMI  Status: NOQUOTA VALBLKR VALBLKW 
 Length   18       4D55445F 5944414C  LADY_DUM 
 Kernel mode       00000000 00005350  PS...... 
 System            00000000 00000000  ........ 
 
Local copy 
 
Lock Database 
------------- 
 
Lock id:  3F000003            PID:    00000000   Flags: VALBLK  CONVERT SYNCSTS 
Par. id:  0100007A            SUBLCKs:       0          CVTSYS 
LKB:      FFFFFFFF.7DF48250   BLKAST: 00000000 
Priority:     0000 
 
Granted at    NL   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF51D50 
Resource:          01F77324 42313146  F11B$s÷.  Status: NOQUOTA VALBLKR VALBLKW 
 Length   10       00000000 00000000  ........ 
 Kernel mode       00000000 00000000  ........ 
 System            00000000 00000000  ........ 
 
Local copy 
 
Lock Database 
------------- 
 
Lock id:  0A000004            PID:    0001000F   Flags: VALBLK  CONVERT SYNCSTS 
Par. id:  00000000            SUBLCKs:       0          SYSTEM  NODLCKW NODLCKB 
LKB:      FFFFFFFF.7DF48350   BLKAST: 81190420          QUECVT 
Priority:     0000 
 
Granted at    EX   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF50850 
Resource:          004F0FDF 24534D52  RMS$ß.O.  Status: VALBLKR VALBLKW 
 Length   26       5F313039 58020000  ...X901_ 
 Exec. mode        00202020 204C354B  K5L    . 
 System            00000000 00000000  ........ 
 
Local copy 
 
   .
   .
   .
      

#2

SDA>  SHOW RESOURCES/LOCKID=0A000004
Resource Database 
----------------- 
RSB:         FFFFFFFF.7DF50850  GGMODE:     EX  Status: DIRENTR VALID 
Parent RSB:  00000000.00000000  CGMODE:     EX 
Sub-RSB count:      0           FGMODE:     EX 
Lock Count:         1           RQSEQNM:  0000 
BLKAST count:       1           CSID: 00000000  (MILADY) 
 
Resource:          004F0FDF 24534D52  RMS$ß.O.  Valblk: 00000000 00000000 
 Length   26       5F313039 58020000  ...X901_          00000000 00000000 
 Exec. mode        00202020 204C354B  K5L    . 
 System            00000000 00000000  ........  Seqnum: 00000000 
 
Granted queue (Lock ID / Gr mode / Range): 
 0A000004  EX 00000000-FFFFFFFF 
 
Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range): 
     *** EMPTY QUEUE *** 
 
Waiting queue (Lock ID / Rq mode / Range): 
     *** EMPTY QUEUE ***
 
      

This SDA session shows the output of the SHOW LOCKS command for several locks. The SHOW RESOURCES command, executed for the last displayed lock, verifies that the lock is in the resource's granted queue. (See Table 4-26 for a full explanation of the contents of the display of the SHOW RESOURCES command.)


This example shows the brief display for all locks with a blocking AST.


Previous Next Contents Index