clearhapreferred (clear HA preferred appliance)

Clears the preferred appliance for a queue manager in a high availability (HA) group.

Purpose

You use the clearhapreferred command to clear the preferred appliance setting for a queue manager.

By default, the preferred appliance for a queue manager is the appliance that the queue manager was created on. You can use the clearhapreferred command to specify that the queue manager has no preferred appliance. You can also use the command when replacing a failed node. The clearhapreferred is used in conjunction with the sethapreferred command.

Syntax

Read syntax diagramSkip visual syntax diagram clearhapreferred QMname

Parameters

QMname
Specify the queue manager that you are clearing the preferred appliance for. The queue manager must be part of an HA group.

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.