deleteWMQQueue command

Use this command to delete a IBM MQ messaging provider queue type destination at a specific scope.

To run the command, use the AdminTask object of the wsadmin scripting client.

[IBM i]The wsadmin scripting client is run from Qshell. For more information, see the topic about configuring Qshell to run product scripts.

This command is valid only when it is used with WebSphere® Application Server Version 7 and later application servers. Do not use it with earlier versions.

For a list of the available IBM® MQ messaging provider administrative commands, plus a brief description of each command, enter the following command at the wsadmin prompt:

print AdminTask.help('WMQAdminCommands')

For overview help on a given command, enter the following command at the wsadmin prompt:

print AdminTask.help('command_name')

After using the command, save your changes to the master configuration. For example, use the following command:

AdminConfig.save()

Purpose

Use the deleteWMQQueue command to delete a IBM MQ messaging provider queue type destination defined at the scope at which the command is issued.

Note: The IBM MQ messaging provider queue type destination definition is deleted from WebSphere Application Server JNDI at the specific scope. Any messages present on the underlying IBM MQ queue are not affected.

Target object

A IBM MQ messaging provider queue type destination at the specific scope.

Required parameters

None.

Optional parameters

None.

Example

  • Using Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>AdminTask.listWMQQueues("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)") 
    unwantedQueue(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986)  
    
    wsadmin>AdminTask.deleteWMQQueue("unwantedQueue(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#MQQueue_1098737234986)") 
  • Using Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>$AdminTask listWMQQueues 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    unwantedQueue(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986)  
    
    wsadmin>$AdminTask deleteWMQQueue 
    unwantedQueue(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986)