change-master-broker

change-master-broker

DRAFT

change-master-broker

changes the master broker in a Message Queue cluster providing JMS services for a \{product---name} cluster.

Synopsis

asadmin [asadmin-options] change-master-broker [--help]
clustered-instance-name

Description

The change-master-broker subcommand changes the master broker in a Message Queue cluster that is the JMS provider for a \{product---name} cluster. By default, the master broker is the one associated with the first instance configured in the \{product---name} cluster.

This subcommand is supported in remote mode only. Remote asadmin subcommands require a running domain administration server (DAS).

Options

asadmin-options: Options for the asadmin utility. For information about these options, see the asadmin(1M) help page.
--help
-?: Displays the help text for the subcommand.

Operands

clustered-instance-name: The name of the server instance whose Message Queue broker is to become the master broker of the Message Queue cluster. This server instance must be an instance in a \{product---name} cluster.

Examples

Example 1 Changing the master broker

The following subcommand changes the Message Queue master broker to the one for the clustinst3 clustered instance.

asadmin> change-master-broker clustinst3
Command change-master-broker executed successfully.

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand