Connecting to and disconnecting from the broker domain

Before you start:

You must complete the following task:

You can connect to, and disconnect from, the broker domain by either using the Message Brokers Toolkit or by using the Configuration Manager Proxy Java API. This topic describes how to use the Message Brokers Toolkit. For information about how to use the Configuration Manager Proxy, see Connecting to the Configuration Manager using the Configuration Manager Proxy.

Use a domain connection to connect to the broker domain in the workbench.

The following steps show you how to connect to the broker domain and how to disconnect from the broker domain.

  1. To connect to the broker domain:
    1. Switch to the Broker Administration perspective.
    2. In the Domains view, right-click the broker domain to which you want to connect, and click Connect. This starts the domain connection to the Configuration Manager.

      When connected, the workbench status line is changed (for example WBRK_QM@localhost:1414 is connected). The Broker Topology and Topics are populated, and the broker domain and broker topology icons change to reflect the connected state.

      On successful connection, the Configuration Manager name is shown in the Domains view in the form ConfigurationManagerName on QMgrName@Hostname:PortNumber.

      Note: If you click Cancel while the connection is being attempted, the connection that is in progress stops and the domain returns to its initial unconnected state.
  2. To disconnect from the broker domain:
    1. Switch to the Broker Administration perspective.
    2. In the Domains view, right click the broker domain from which you want to disconnect, and click Disconnect. The connection to the Configuration Manager is broken.

      When disconnected, the workbench status line is changed (for example WBRK_QM@localhost:1414 is not connected). All brokers and topics are removed from the domains navigator tree, and the broker domain and broker topology icons change to reflect the disconnected state.

Related concepts
Broker domains
Configuration Manager
Related tasks
Creating a domain connection
Modifying domain connection properties
Deleting a domain connection