Removing a queue manager from a high availability group by using the command line

You can remove a queue manager from a high availability (HA) group and run it as a stand-alone queue manager by using the sethagrp command on the command line.

Before you begin

If the queue manager is also part of a disaster recovery (DR) configuration, you must remove it from the DR configuration before you remove it from the HA group. See Removing a queue manager from a disaster recovery configuration by using the command line.

About this task

You must run the command on the queue manager primary appliance (the appliance that the queue manager is running on). You can discover where the queue manager is running by using the dspmq command or the status qmanager command. Either command will report the status as Running for the current appliance, or Running elsewhere for the other appliance in the HA group.

Procedure

  1. Enter the IBM® MQ administration mode by entering the following command:

    mqcli

  2. Enter the following command to stop the queue manager:
    endmqm QMname
    
  3. Enter the following command to remove the queue manager from the HA group and run it as a stand-alone queue manager:
    sethagrp -e QMname 
    
    Where QMname is the name of the queue manager. The queue manager is removed from the group. You must then use the strmqm command to start the queue manager.
  4. Optional: Exit the IBM MQ administration mode by entering the following command:

    exit

Example

The following example shows the queue manager HAQM1 being removed from the HA group:
sethagrp -e HAQM1