Canceling a deployment that is in progress

You can cancel all outstanding deployments in the domain, or just those sent to a particular broker. But cancel a deployment only as a last resort and be sure that the brokers affected, will never be able to process a previous deployment request.

Before you start:

Make sure that you understand the implications of this action. See Cancel deployment.

Make sure that you have the necessary access authority:
  • When canceling deployment across the domain, you must have full access authority on the Configuration Manager.
  • When canceling deployment to a specific broker, you must have full access authority on that broker.
To ensure that previous deployment messages are not processed when an affected broker is restarted, first remove all existing deployment messages:
  1. Stop the broker.
  2. Check the two queues used by the broker: SYSTEM.BROKER.ADMIN.QUEUE and SYSTEM.BROKER.EXECUTIONGROUP.QUEUE. Manually remove all deployment messages.
  3. Proceed to cancel the deployment.

Using the Message Brokers Toolkit

Check the details at the start of this topic, and then follow these steps to cancel the deployment to a particular broker or all outstanding deployments in a domain, using the workbench:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, right-click either a particular broker or a connected domain.
  3. Click Cancel Deployment.

Deployments to the broker or domain are canceled.

Next:

Checking the results of deployment. A BIP0892I information message is displayed to show that the request was received by the Configuration Manager.

Using the mqsideploy command

Check the details at the start of this topic, and then follow these steps to cancel a deployment using the mqsideploy command:

  1. Open a command window that is configured for your environment.
  2. Using the examples below, enter the appropriate command, typed on a single line:
    z/OS platform On z/OS®:
    /f MQ01CMGR,dp t=yes b=B1

    This command cancels deployment to the broker called B1. Omit the b argument to cancel all outstanding deployments in the domain. MQ01CMGR is the name of the Configuration Manager component.

    On other platforms:
    mqsideploy -i ipAddress -p port -q qmgr –c –b B1

    This command cancels deployment to the broker called B1. Omit the -b parameter to cancel all outstanding deployments in the domain.

    The -i (IP address), -p (port), and -q (queue manager) parameters represent the connection details of the queue manager workstation.

Next:

Checking the results of deployment. A BIP0892I information message is displayed to show that the request was received by the Configuration Manager.

Using the Configuration Manager Proxy

First, check the details at the start of this topic

To cancel all outstanding deployments in a domain
Use the cancelDeployment method of the ConfigManagerProxy class. For example:
public class CancelAllDeploys {
  public static void main(String[] args) {
    ConfigManagerConnectionParameters cmcp =
            new MQConfigManagerConnectionParameters
                ("localhost", 1414, "QM1");
    try {
      ConfigManagerProxy cmp =
            ConfigManagerProxy.getInstance(cmcp);
      cmp.cancelDeployment();
    }
    catch (ConfigManagerProxyException e) {
      e.printStackTrace();
    }
  }
} 
To cancel deployment to a specific broker in a domain
Use the cancelDeployment method of the BrokerProxy class. For example, to cancel deployment to a broker called B1:
import com.ibm.broker.config.proxy.*;

public class CancelDeploy {
  public static void main(String[] args) {
    ConfigManagerConnectionParameters cmcp =
            new MQConfigManagerConnectionParameters
                ("localhost", 1414, "QM1");
    try {
      ConfigManagerProxy cmp =
            ConfigManagerProxy.getInstance(cmcp);
      TopologyProxy t = cmp.getTopology();
      BrokerProxy b = t.getBrokerByName("B1");
      b.cancelDeployment();
    }
    catch (ConfigManagerProxyException e) {
      e.printStackTrace();
    }
  }
} 

Next:

Checking the results of deployment. A BIP0892I information message is displayed to show that the request was received by the Configuration Manager.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:21:52

af03940_