gtpo1madOperations

ZMQSC DEL-Delete a TPF MQSeries Resource

Use this command to delete a TPF MQSeries channel, alias queue, local queue, or remote queue.

Requirements and Restrictions

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

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.