gtpo1m49Operations

ZDLCK DISPLAY-Display Lock Names

Use this command to display locks in a coupling facility (CF).

Requirements and Restrictions

None.

Format




LOCKname-lockname
displays information about a specific lock, where lockname is the 16-digit hexadecimal lock name.

FA-fileaddr
displays information about the locks for the specified address, where fileaddr is the 8- or 16-digit hexadecimal file address.

MOD-modnumber
displays information about locks for the specified module, where modnumber is the 1- to 4-digit hexadecimal symbolic module number.

Vsync
indicates only information about virtual file access (VFA) synchronization locks is to be displayed.

Rht
indicates only information about the record hold table (RHT) (exclusive) locks is to be displayed.

Additional Information

Examples

The following information is displayed in the examples:

 LOCKNAME 
is the address of the locked record (for example, 0000007901040000).

 MCHR 
is the hexadecimal module, cylinder, head and record (MCHR) of the locked record.

 SS 
is the name of the subsystem that owns the record.

 TYPE 
is the lock type; either RHT or VFA.

 STATE 
is the state in which the lock is held; either EXCLUSIVE or SHARED.

 SDA 
is the symbolic device address (SDA) of the device where the record resides (for example, 0F20).

 LOCK HOLDER LIST 
is the processor identifier (ID) of one or more processors holding the record.

 EXCLUSIVE LOCK WAITER LIST 
is the processor ID of one or more processors waiting to get an exclusive lock on the record.

 SHARED LOCK WAITER LIST 
is the processor ID of one or more processors waiting to get and share the lock on the record.

 FIRST WAITER 
is the processor ID of the processor that gets the lock next.

All the locks for the specified file address are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:    ZDLCK DISPLAY FA-F403D001                                              |
|                                                                                |
|System:  CLM80009I 21.28.17 ZDLCK DISPLAY STARTS                                |
|         LOCKNAME         MCHR            SS    TYPE STATE          SDA         |
|         0000007901040000 00470079000104  BSS   RHT  EXCLUSIVE      0EE5        |
|         LOCK HOLDER LIST           B                                           |
|         EXCLUSIVE LOCK WATIER LIST  C   _                                      |
|         SHARED LOCK WAITER LIST    NONE                                        |
|         FIRST WAITER                C                                          |
|         LOCKNAME         MCHR            SS    TYPE  STATE         SDA         |
|         0000007901040080 00470079000104  BSS   SYNC  EXCLUSIVE     0EE5 _      |
|         LOCK HOLDER LIST           B                                           |
|         EXCLUSIVE LOCK WAITER LIST  C                                          |
|         SHARED LOCK WAITER LIST    NONE                                        |
|         FIRST WAITER                C                                          |
|         ZDLCK DISPLAY COMPLETE                                                 |
+--------------------------------------------------------------------------------+

The following example displays information about the specified lock.

+--------------------------------------------------------------------------------+
|User:    ZDLCK DISPLAY LOCKNAME-0000007901040000                                |
|                                                                                |
|System:  CLM80009I 08.40.54 ZDLCK DISPLAY STARTS                                |
|         LOCKNAME         MCHR            SS    TYPE STATE        SDA           |
|         0000007901040000 00470079000104  BSS   RHT  EXCLUSIVE    0EE5          |
|         LOCK HOLDER LIST           B                                           |
|         EXCLUSIVE LOCK WAITER LIST  C   _                                      |
|         SHARED LOCK WAITER LIST    NONE                                        |
|         FIRST WAITER                C                                          |
|         ZDLCK DISPLAY COMPLETE                                                 |
+--------------------------------------------------------------------------------+

The following example displays all the locks for a particular module. The following information is displayed in this example:

 LOCKNAME 
is the address of the locked record (for example, 0000007901040000).

 S 
is the lock state, either X for exclusive or S for shared.

 HOLDERS 
is the lock holder list in bit format with the first processor being the high order bit in the first byte.

 XWAIT 
is the exclusive lock waiter list in bit format.

 SWAIT 
is the shared lock waiter list in bit format.

 FW 
is the first waiter in bit format.
+--------------------------------------------------------------------------------+
|User:    ZDLCK DISPLAY MOD-047                                                  |
|                                                                                |
|System:  CLM80011I 11.22.47 ZDLCK DISPLAY MOD STARTS                            |
|         LOCKNAME         S HOLDERS  XWAIT    SWAIT    FW                       |
|         0000007901040000 X 80000000 00000000 00000000 0                        |
|         0000007901080000 X 80000000 00000000 00000000 0                        |
|         0000007902040080 S 80000000 00000000 00000000 0                        |
|         ZDLCK DISPLAY MOD COMPLETE                                             |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Information