gtpo1me4Operations

ZRHLD DISPLAY-Display Lock Names

Use this command to display the lock names that exist in control unit lock tables.

Requirements and Restrictions

None.

Format




ALL
displays information about all the locks for the control unit of a specified device.

sda
is the 4-digit hexadecimal symbolic address of a device.

SL
displays information about all the special locks.

PR-id
displays information about all the locks for a specific processor, where id is the 1-character alphanumeric CPU ID of the processor.

VSYNC
displays information about the virtual file access (VFA) synchronization lock.

LOCkname
displays information about a specific lock.

LN
displays information about a specific lock.

lockname
is the 16-digit hexadecimal lock name.

FA fileaddr
displays information about the lock for a specific record, where fileaddr is the 8- or 16-digit hexadecimal file address.

DEVice
displays information about the locks for the specified device, which must be mounted and in use.

CONTinue
continues to display the information about the locks.

Additional Information

Examples

The following information is displayed in the examples:

 LOCKNAME 
is the physical address of the locked record (for example, 02020075) and the number of the device where the lock is held (for example, 40).
Note:
The device number is a control byte in the format FFFD DDDD, where F is a flag and D is a device address bit.

 HOLDERS 
is the CPU ID of the processor that is holding the record.

 FILE ADDRESS 
is the file address of the locked record. If a general file is locked, GF is displayed. If a general data set is locked, GDS is displayed. If it is a special lock, SPECIAL is displayed. If the module, cylinder, head and record (MCHR) from the lock name cannot be translated into a file address, UNKN is displayed.

 SUBSYS 
is the name of the subsystem that owns the record. If it is a special lock, UNKN is displayed.

 WAITERS 
is the CPU ID of the processor that is waiting for the record. If there are no waiters, NONE is displayed.

 SDA 
is the symbolic device address of the device where the record resides. Special locks always have the base control unit address assigned. If the SDA is not mounted, active, or valid, UNKN is displayed.

All the normal and special locks for the control unit of the specified device are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZRHLD DIS ALL EE5                                                       |
|                                                                                |
|System: RHLD0111I 16.03.03                                                      |
|            LOCKNAME         FILE ADDRESS    SUBSYS  SDA                        |
|        00720003 65000080  00000000F403A809   BSS    0EE5                       |
|          HOLDERS  B                                                            |
|          WAITERS  NONE                                                         |
|        LOCK DISPLAY COMPLETE                                                   |
+--------------------------------------------------------------------------------+

The following example displays information about the lock for the specified record.

+--------------------------------------------------------------------------------+
|User:   ZRHLD DISP FA F403A845 VSYNC                                            |
|                                                                                |
|System: RHLD0111I 08.40.54                                                      |
|            LOCKNAME         FILE ADDRESS    SUBSYS  SDA                        |
|        00020988 65000080  00000000F403A805   BSS    0EE5                       |
|          HOLDERS  C                                                            |
|          WAITERS  B                                                            |
|        LOCK DISPLAY COMPLETE                                                   |
+--------------------------------------------------------------------------------+

The following example displays information about the specified lock.

+--------------------------------------------------------------------------------+
|User:   ZRHLD DISP LN 0002098865000000 EE5                                      |
|                                                                                |
|System: RHLD0111I 08.40.54                                                      |
|            LOCKNAME         FILE ADDRESS    SUBSYS  SDA                        |
|        00020988 65000000  00000000F403A805   BSS    0EE5                       |
|          HOLDERS  B                                                            |
|          WAITERS  C                                                            |
|        LOCK DISPLAY COMPLETE                                                   |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Information

None.