ADDRESS PPQ Commands › PPQ Operations Commands › UNLOCK Command

UNLOCK Command

The UNLOCK command restores access to a queue locked by a previously issued LOCK command.

This command has the following format:

ADDRESS PPQ 'UNLOCK QUEUE(qname)'

QUEUE

Specifies the 1- to 16-character name of the queue (qname). The queue name can contain alphanumeric characters and any of these special characters: ! @ # $ _

The queue name cannot contain blanks.

Usage Notes:

• Unlock a queue as soon as possible after you lock it to prevent unnecessary delays in other REXX programs.
• Locks are nested. For every LOCK command issued for a queue, an equal number of UNLOCK commands is required to completely remove the lock.

  You can retrieve the lock nesting count using the LIST command.

• It is good programming practice for user-written programs to eventually unlock every queue that they have locked.