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
- A special lock is a lock that has bit 0 of byte 4 (the fifth
byte in the lock name) set, and is used by the TPF system for controlling
special functions. A normal lock is a lock that has the same
bit reset.
- If all the information about the locks cannot be displayed on the screen
at one time, enter ZRHLD DISPLAY CONTINUE in 4 minutes to display
the remaining locks.
- Enter the ZRHLD DELETE command to delete locks.
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.