docs/reference-manual/src/main/asciidoc/change-master-broker.adoc

type=page
status=published
title=change-master-broker
next=change-master-password.html
prev=change-admin-password.html
~~~~~~

= change-master-broker

[[change-master-broker-1]][[GSRFM00005]][[change-master-broker]]

== change-master-broker

Changes the master broker in a Message Queue cluster providing JMS
services for a {productName} cluster.

[[sthref53]]

=== Synopsis

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

[[sthref54]]

=== Description

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

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

[[sthref55]]

=== Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.

[[sthref56]]

=== 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 {productName} cluster.

[[sthref57]]

=== Examples

[[GSRFM449]][[sthref58]]

==== Example 1   Changing the master broker

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

[source]
----
asadmin> change-master-broker clustinst3
Command change-master-broker executed successfully.
----

[[sthref59]]

=== Exit Status

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

[[sthref60]]

=== See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]