WebSphere Message Brokers
File: ae03375_
Writer: Bill Oppenheimer

Task topic

This build: July 31, 2007 21:27:19

Modifying domain connection properties

Before you start:

To complete this task, you must have completed the following tasks:

Modify the parameters of the .configmgr domain connection file that are used to connect to the Configuration Manager.

To modify the domain connection properties.

  1. Switch to the Broker Administration perspective.
  2. In the Broker Administration Navigator view, expand Domain Connections, and open your server project.
  3. Right-click the .configmgr domain connection file and click Open With > Domain Connection Editor. From here you can change:
    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. This property is mandatory.
    3. The TCP port on which the WebSphere MQ queue manager is listening. This property must be a valid positive number.
    4. Optional: The name of the server-connection channel. The channel has a default name of SYSTEM.BKR.CONFIG.

      You can create more than one server-connection channel and define a different SSL certificate on each channel to enforce, for example, users with view access on to one channel and users with deploy access on to a different channel.

      You can then create WebSphere MQ exits on each channel to provide additional authentication of the WebSphere MQ message sent to the Configuration Manager.

      You must create the server-connection channel manually on the Configuration Manager's queue manager by using the WebSphere MQ:
      • runmqsc command to create a channel with options CHLTYPE(SVRCONN) and TRPTYPE(TCP), or
      • Explorer to create a server-connection channel with the transmission protocol set to TCP.
      For more information see your WebSphere MQ documentation.

      The default name of SYSTEM.BKR.CONFIG is assumed if you do not change the name, or attempt to delete it. The name of the server-connection channel is changed only if you enter another name in place of SYSTEM.BKR.CONFIG.

    5. Optional: The name of the Security Exit required to connect to the WebSphere MQ queue manager. This property must be a valid Java class name, but it is not mandatory and you can leave it blank, if it does not apply to your domain connection.
    6. 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.
    7. 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.
  4. Close the editor.
  5. You are prompted to save the changes; click Yes. If the broker domain is connected, you are prompted to disconnect before you can save your changes. The .configmgr domain connection file is updated with the new parameters.

You can also change the domain connection parameters for a disconnected domain, from the Domains view. Right-click the disconnected domain and click Edit Parameters. This opens the Domain Connection editor. Follow steps 3 to 5 above to make the changes you require.

Related concepts
Broker domains
Configuration Manager
Security exits
Related tasks
Creating a domain connection
Deleting a domain connection
Using security exits
Related reference
Broker Administration perspective
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:27:19

ae03375_ This topic's URL is: