Use this command to delete locks from control unit or coupling facility
(CF) lock tables.
Requirements and Restrictions
- Delete locks from active processors only in emergencies. No checks
are performed when you enter this command and the lock is deleted. This
can cause the CCSONS program to issue system error 00038. If the lock
resides on a coupling facility (CF), the CCCFLC program can issue system error
004627 instead. If another processor is waiting for the lock, that
processor is notified that the lock was deleted. If the lock is
currently held by an entry control block (ECB) on this processor, the ECB is
forced to exit, system error 0000DA is issued, and the lock is deleted from
the record hold table (RHT).
- When a lock is on the CF you can only delete the lock from the processor
that is holding (holder) the lock. Additionally, when the lock is on
the CF and the processor is waiting for the lock, you can only delete the
request for the lock from the processor that is waiting (waiter) for the
lock.
Format
- INACTive
- deletes all locks that are held by inactive processors.
- Note:
- You can specify this parameter only for the basic subsystem (BSS).
- LOCkname
- deletes a specific lock.
- LN
- deletes a specific lock.
- lockname
- is the 16-digit hexadecimal lock name.
- sda
- is the 4-digit hexadecimal symbolic address of a device.
- FA fileaddr
- deletes the lock for a specific record, where fileaddr is an 8-
or 16-digit hexadecimal file address.
- Note:
- To translate the file address correctly, use this parameter only for the
subsystem and subsystem user (SSU) that owns the specified file
address.
- VSYNC
- deletes the virtual file access (VFA) synchronization lock. If you
do not specify this parameter, the RHT lock is deleted.
Additional Information
Enter the ZRHLD DISPLAY command to display information about the
locks.
Examples
The following example shows that all the locks held by inactive processors
are being deleted.
+--------------------------------------------------------------------------------+
|User: ZRHLD DELETE INACT |
| |
|System: RHLD0000I 08.40.54 LOCK DELETIONS COMPLETE |
+--------------------------------------------------------------------------------+
The following example shows lock 0F05038A43000080 for device 03E3 being
deleted.
+--------------------------------------------------------------------------------+
|User: ZRHLD DEL LN 0F05038A43000080 03E3 |
| |
|System: RHLD0021I 08.40.54 LOCK DELETION COMPLETE, CTL-38 MAY OCCUR |
+--------------------------------------------------------------------------------+
The following example shows the VFA synchronization lock for file address
F403A805 being deleted.
+--------------------------------------------------------------------------------+
|User: ZRHLD DEL FA F403A805 VSYNC |
| |
|System: RHLD0021I 08.40.54 LOCK DELETION COMPLETE, CTL-38 MAY OCCUR |
+--------------------------------------------------------------------------------+
Related Information
See TPF Database Reference for more information
about CF record lock support and deleting locks.