Use this command to remove all messages from a local normal queue.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before you enter this command.
- You cannot clear a transmission queue that is in use by an active
channel.
- For processor unique queues, the queue is cleared only on the processor on
which you enter the command.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
Format
- QL-qlname
- specifies the name of the local queue to be cleared, where qlname
is the 1- to 48-character queue name. A queue name can contain percent
signs (%), slashes (/), underscores (_), periods (.),
letters in either uppercase (A-Z) or lowercase (a-z), and digits
(0-9). If the name is enclosed in single quotation marks, the
characters can be mixed case.
- FORCE
- clears a queue even if there were errors when removing messages from the
queue.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
Examples
The following example clears the LOCALQ queue:
+--------------------------------------------------------------------------------+
|User: ZMQSC CLEAR QL-LOCALQ |
| |
|System: MQSC0219I 08.45.03 ALL MESSAGES REMOVED FROM LOCAL QUEUE LOCALQ |
| |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about the MQSeries product.