WebSphere Message Brokers
File: an27050_
Writer: Bill Oppenheimer

Task topic

This build: July 31, 2007 21:34:02

Connecting to and disconnecting from the broker domain on z/OS

This topic describes how to connect to, and disconnect from, the broker domain on z/OS.

Before you start:

You must complete the following tasks:

Ensure that your Message Brokers Toolkit machine and user ID have the appropriate authorization on the z/OS Configuration Manager.

In SDSF, grant access to your user ID.
  1. For this to work on all machines, enter:
    '/F <started task name> CA U=<userID>,A=YES,P=YES,X=F'
    or to grant access to your user ID for a specific machine, enter:
    '/F <started task name> CA U=<userID>,A=YES,M=<machine name>,P=YES,X=F'
  2. Verify the above by entering:
    /F <configmgrname>,LA
This topic shows you how to:

To create a domain connection:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, right-click the default configuration manager.
  3. Click New > Domain Connection to open the Create a Domain Connection wizard.
  4. In the Create a Domain Connection wizard, enter:
    1. The value for the Queue Manager Name 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 Class of the Security Exit required to connect to the WebSphere MQ queue manager. This property must be a valid Java™ class name, but you can leave this field empty if it does not apply to your domain connection. See Using security exits.
    5. Optional: The JAR File Location for the Security Exit required to connect to the WebSphere MQ queue manager. Click Browse to find the file location. You can leave this field empty if it does not apply to your domain connection.
      Note: The JAR File Location 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 are required when enabling SSL. See Implementing SSL authentication. The Cipher Suite field displays available cipher suites. Click More to configure Custom SSL Cipher Suites 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 Name, Host name, or TCP Port number. An error message is displayed in the Create a Domain Connection wizard if you try to create a second broker domain using the same Queue Manager Name, Host name, and Port number.

  5. Click Next to begin the domain connection to the Configuration Manager.
  6. If you click Cancel, the Create a Domain Connection wizard closes, forcing disconnection from the domain.
  7. After the domain connection has been made, enter:
    1. The name of your Server Project. The Server Project 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. The Connection name is the name you give to the .configmgr file that contains the parameters to connect to the Configuration Manager.
  8. Click Finish to create the domain connection.

    The new domain connection is added to the Broker Administration Navigator view, under Domain Connections. 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 on z/OS
Modifying domain connection properties
Deleting a domain connection
Notices | Trademarks | Downloads | Library | Support | Feedback

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

an27050_ This topic's URL is: