sethapreferred (set HA preferred appliance)

Sets a preferred appliance in the high availability (HA) group for a queue manager to run on.

Purpose

You use the sethapreferred command to specify which appliance in an HA pair a queue manager should run on, provided that the appliance is available.

By default, the preferred appliance for a queue manager is the appliance that the queue manager was created on. You can use the sethapreferred command in circumstances such as replacing a failed node, or specifying the favored appliance when an existing queue manager is added to an HA group. The sethapreferred is used in conjunction with the clearhapreferred command.

You run the command on the appliance that you want to be the preferred appliance, specifying the queue manager name. If the queue manager is currently running on the other appliance, it will fail over to this appliance, provided that is possible (for example, data replication between the two appliances must be up to date).

Syntax

Read syntax diagramSkip visual syntax diagram sethapreferred QMname

Parameters

QMname
Specify the queue manager that you are setting the preferred appliance for.

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.