Use this command to delete a TPF MQSeries channel, alias queue, local
queue, or remote 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 entering this 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
- PROCESS-processname
- specifies the name of a process object that is to be deleted on the local
queue manager, where processname is the 1- to 48-character process
name. A process name can contain percent signs (%), slashes
(/), underscores (_), periods (.), letters in either uppercase
(A-Z) or lowercase (a-z), and digits (0-9). If
processname is enclosed in single quotation marks, the characters can
be mixed case.
- CHL-name
- specifies the name of the channel definition to be deleted, where
name is the 1- to 20-character channel name. A channel 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. The name must be
that of an existing channel.
- Note:
- Ensure the channel is stopped before you specify this parameter to delete the
channel.
- CPU
- deletes a TPF MQSeries channel from the specified central processing unit
(CPU), where:
- cpuid
- is a 1-character CPU identifier (ID).
- ALL
- deletes the channel from all the processors in the TPF system.
- localid
- is the local CPU ID from which the command is currently running.
This is the default.
- QL-qlname
- specifies the name of a local queue to be deleted, 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. The name must be defined to the local TPF
MQSeries queue manager.
- PURGE
- deletes a specified local queue even if there are still messages on that
queue, where:
- procid
- is a 1-character processor identifier (ID) that is only valid for
processor unique queues.
- ALL
- deletes the local queue on all processors and is required for queues
defined with the COMMON parameter set to YES.
- QR-qrname
- specifies the remote queue to be deleted, where qrname 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. The name must be defined to the local TPF
MQSeries queue manager.
- QA-qaname
- specifies the alias queue to be deleted, where qaname 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. The name must be defined to the local TPF
MQSeries queue manager.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZMQSC HELP
ZMQSC ?
- The resource is deleted from all processors in a loosely coupled complex,
except when you specify a channel name. To delete a channel from all
processors in a loosely coupled complex, you must specify the CPU parameter
with a value of ALL.
- If the queue is not empty when you enter the ZMQSC DEL command with the QL
parameter specified, the queue will be deleted when the queue becomes empty
unless the PURGE parameter is specified.
- You cannot delete a transmission queue if it is associated with an active
channel.
Examples
The following example deletes the CreditCard process.
+--------------------------------------------------------------------------------+
|User: ZMQSC DEL PROCESS-'CreditCard' |
| |
|System: MQSC0723I 09.17.22 PROCESS-CreditCard DELETED SUCCESSFULLY |
+--------------------------------------------------------------------------------+
The following example deletes a TPF MQSeries resource definition
(channel).
+--------------------------------------------------------------------------------+
|User: ZMQSC DEL CHL-TPF.TO.OS2 |
| |
|System: MQSC0010I 08.41.05 DELETE CHANNEL DEFINITION SUCCESSFUL |
+--------------------------------------------------------------------------------+
The following example deletes a TPF MQSeries resource definition (local
queue).
+--------------------------------------------------------------------------------+
|User: ZMQSC DEL QL-LOCAL1 |
| |
|System: MQSC0607I 08.41.05 DELETION OF QUEUE LOCAL1 STARTED |
+--------------------------------------------------------------------------------+
The following example deletes a TPF MQSeries resource definition (remote
queue).
+--------------------------------------------------------------------------------+
|User: ZMQSC DEL QR-TPF.TO.OS2.QUEUE |
| |
|System: MQSC0018I 08.41.05 DELETE REMOTE QUEUE SUCCESSFUL |
+--------------------------------------------------------------------------------+
Related Information
See MQSeries Command Reference for more
information about the MQSeries product.