ADDRESS PPQ Commands › PPQ Dismantling Commands › DELETE Command

DELETE Command

The DELETE command deletes all elements in the specified queue and releases the memory allocated for the queue.

This command has the following format:

ADDRESS PPQ 'DELETE QUEUE(qname) [WAIT(NO|YES|waittime)]'

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.

WAIT

(Optional) Specifies what the command does if it cannot execute immediately. For example, the queue may be in use or locked by another REXX program. Valid WAIT values are:

NO

Returns a nonzero return code (RC) value immediately. (For information about what happens when a command does not execute successfully, see the chapter on using program-to-program queues in the Administrator Guide.

YES

Waits indefinitely while blocking the current REXX program until the queue becomes available.

waittime

Specifies the number of seconds to wait (up to 100000) while blocking the current REXX program. Fractional values (such as 1.5) are valid.

Default: NO

Usage Notes:

The following restrictions apply to the DELETE command:

• If the queue you want to delete is a network-shared queue--that is, if it was created with the CREATE command's SHARE(YES) option--the DELETE command first makes the queue local (unshared) so that it can delete the queue.
• You can delete only local queues. The only way to delete a remote queue is through a REXX program on the machine where the queue resides.
• You cannot delete a locked queue unless the calling REXX program is also the lock holder.
• A temporary queue--created with the CREATE command PERSISTENCE(TEMPORARY) option--can be deleted only by the REXX program that created it.