WebSphere Message Brokers
File: an26010_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:33:56

mqsideleteexecutiongroup command

Supported platforms

Purpose

Use the mqsideleteexecutiongroup command to delete an execution group from a broker.

You must start the Configuration Manager before you can issue this command.

If you are deleting an execution group to which a deployment has previously been made, you must also start the broker before issuing this command.

Syntax

Parameters

-b BrokerName
(Required) The name of the broker on which the execution group resides.
-e ExecutionGroupName
(Required) The name of the execution group to delete.
-n CfgParameterFileName
(Optional) This parameter specifies the name of a .configmgr file that describes the connection parameters to the Configuration Manager.
The file is in XML, using the .configmgr format that is saved by the workbench; for example:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
If you are using this file on z/OS you must remove the statement encoding="UTF-8" from the first line, and remove the value for the host attribute, to leave the statement as:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Note: If you do not supply this parameter, you must supply the -i, -p, and -q parameters.
-i IpAddress
(Optional) This parameter specifies the host name or IP address of the Configuration Manager.

If you are using this parameter on z/OS and want to connect to the local host you must set the value to "".

-p Port
(Optional) This parameter is the port number of the Configuration Manager.
-q QMgr
(Optional) This parameter specifies the name of the WebSphere MQ queue manager that the Configuration Manager is using.

If you do not supply the -i, -p, and -q parameters, you must specify the -n parameter.

-w TimeoutValue
(Optional) This parameter is the time in seconds that the utility waits to ensure that the command completed; the default value is 60.
-v TraceFileName
(Optional) This parameter sends internal debug trace information to the specified file.

Authorization

On Windows platforms, Linux, and UNIX systems, you need to be a member of the 'mqm' group and the command only succeeds if the user ID running the command has the correct authority defined in the Configuration Manager’s access control list.

In order to delete an execution group, full control authority is required over the broker object; see ACL permissions for a list of permissions that can be defined in the Configuration Manager.

Responses

This command returns the following responses:
0
(Success) States that the request completed successfully and the execution group has been deleted successfully. If the command was to delete an execution group to which a deployment has previously been made, this return code means that the broker has stopped and released all resources associated with that execution group, for example, message flows.
2
(Failure) States that the execution group could not be deleted for any reason.
98
States that the Configuration Manager cannot be reached.
99
States that the supplied arguments to the utility are not valid.

Examples

On the domain controlled by the Configuration Manager whose queue manager is called QMGR and is listening on fred.abc.com:1414, delete an execution group called ‘EG1’ on broker 'BROKER’.

  mqsideleteexecutiongroup -i fred.abc.com -p 1414 -q QMGR -b BROKER –e EG1

On the domain specified by the file domain1.configmgr, delete an execution group called ‘EG2’ on broker 'BROKER’.

  mqsideleteexecutiongroup –n domain1.configmgr –b BROKER –e EG2 

On the domain specified by the file domain2.configmgr, delete an execution group ‘EG3’ on broker ‘FRED’. Wait five minutes for the Configuration Manager to tidy up any resources and send output to trace.txt.

  mqsideleteexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:56

an26010_ This topic's URL is: