Creating a domain connection

Before you start:

You must complete the following tasks:

Create a domain connection in the workbench using the Create a New Domain Connection wizard. Enter a set of parameters to create a .configmgr file. The parameters contained within the .configmgr file are used to connect to the Configuration Manager, where you can view and edit your broker domain.

To create a domain connection:

  1. Switch to the Broker Administration perspective.
  2. Right-click in the Domains view, and click New > Domain
  3. In the Create a New Domain Connection wizard, enter:
    1. The name of the WebSphere MQ queue manager that the Configuration Manager is using. This property is mandatory.
    2. The host name or IP address of the machine on which the Configuration Manager is running (the default is localhost). This property is mandatory.
    3. The TCP port on which the WebSphere MQ queue manager is listening (the default is 1414). This property must be a valid positive number.
    4. Optional: The name of the Security Exit required to connect to the WebSphere MQ queue manager. This property must be a valid Java classname, but you can leave this box blank if it does not apply to your domain connection.
    5. Optional: The location of the JAR file for the Security Exit required to connect to the WebSphere MQ queue manager. Use the Browse button to find the file location. You can leave this box blank if it does not apply to your domain connection.
      Note: The location of the JAR file is required if a Security Exit class is entered.
    6. Optional: The cipher suite, distinguished names, CRL name list, key store, and trust store parameters required when enabling SSL (see Implementing SSL authentication for more information). The cipher suite field displays available cipher suites. Click More to configure a custom cipher suite in the Broker Administration preferences window. If a cipher suite is not specified, all other fields in the SSL section are unavailable.

      You can configure several domain connections in your workspace. Each domain connection has to address a different Configuration Manager, which needs to have a different WebSphere MQ queue manager, host name, or TCP port number. An error message is displayed in the wizard, if you try to create a second broker domain using the same queue manager, host name, and port number.

  4. Click Next to begin the domain connection to the Configuration Manager.

    You cannot connect to a Version 2.1 Configuration Manager. An error is thrown, and you will not be able to populate the domain with brokers or topics, or connect to it using the workbench.

  5. If you click Cancel, the Create a New Domain Connection wizard closes and a forced disconnection from the domain occurs.
  6. After the domain connection has been made, enter:
    1. The name of your Server Project. This is the container for your domain connection. If you have not already created a server project, you can specify the name of a new project here. The server project is created with the domain connection.
    2. The Connection Name. This is the name you give to the .configmgr file that contains the parameters to connect to the Configuration Manager.
  7. Click Finish to create the domain connection.

    The new domain connection is added to the Broker Administration Navigator view, under Domain Connections. Here the server project holds the .configmgr domain connection file.

    The view of the broker domain is displayed in the Domains view.

Related concepts
Broker domains
Configuration Manager
Security exits
Related tasks
Creating a Configuration Manager
Modifying domain connection properties
Deleting a domain connection
Connecting to and disconnecting from the broker domain
Using security exits
Related reference
Broker Administration perspective