sethagrp (set HA group)

Purpose

You use the sethagrp command to pause the high availability (HA) group on an appliance. Any queue managers running on that appliance fail over to the other appliance in the group. You can then use sethagrp to resume a previously paused HA group on the appliance.

You can also use the sethagrp command to add a standalone queue manager to an HA group, or to remove a queue manager from an HA group and run it as a stand-alone queue manager.

You cannot remove a queue manager from an HA group if it is also part of a disaster recovery (DR) configuration. In that case, you must remove the DR configuration from the queue manager before you run the sethagrp command, see dltdrprimary.

Parameters

-s

Suspend the HA group on the appliance into standby mode.

-r

Resume the HA group on the appliance from standby mode.

-i QMname

Add an existing queue manager to the HA group. The queue manager must not already be under HA control and must be currently stopped. The queue manager is started automatically after the command is completed.

You cannot use this command on a queue manager that is already part of a DR configuration.

-e QMname

Remove a queue manager from the HA group. The queue manager must be under HA control and be currently stopped. You must run the command on the appliance that the queue manager was running on when it was stopped. You can discover where the queue manager is running before you stop it 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.

You cannot use this option if the queue manager is also part of a DR configuration.

Use the strmqm command to restart the queue manager after the command is completed.

-u QMname [-f] | -u -a [-f]

Upgrade a queue manager from version 9.3 to run in version 9.4. You can upgrade single queue managers by specifying the queue manager name, or you can upgrade all HA queue managers by specifying the -a option (use -a with caution, it is recommended that you upgrade one queue manager at a time).

Specify the -f option to force the completion of the upgrade even if the current appliance cannot communicate with the other appliance in the HA group over either of the replication links.

CAUTION:

Use the -f option only if you have an urgent need to run the queue manager, because you will likely have partitioned data when you restore the other appliance.

Usage Notes

• This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.