WebSphere Message Brokers
File: ae12720_
Writer: Bill Oppenheimer

Task topic

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

Creating a broker on Windows

On Windows, you can create brokers on the command line or using the Command Assistant wizard in the Message Broker Toolkit.

Before you start:

When you create a broker, if the WebSphere MQ queue manager does not already exist, the queue manager is automatically created. The broker database must already exist but the tables in which the broker stores its internal data are created automatically when the first broker to use that database is created. Subsequent brokers that are created using the same database and database userid will share these tables.

To create a broker:

  1. Ensure that the user ID with which the broker will connect to the broker database is authorized to create tables in the broker database. If you are not sure, check with your database administrator (DBA). The broker will connect to the broker database using the user ID and password that you will specify in the -i and -u parameters of the mqsicreatebroker command when you create the broker.

    For more information, see Authorizing access to the databases.

  2. Define the ODBC data source name (DSN) of the broker database to enable the broker to make a connection. Multiple brokers on the same host can use the same ODBC DSN to connect to the same broker database.

    For more information, see Enabling connections to the databases.

  3. Open a WebSphere Message Broker command prompt for the runtime installation in which you want to create the broker. For more information about initializing the runtime environment, see Command environment: Windows platforms.
  4. Use the mqsicreatebroker command to create the broker.
    For example, if you want to create a broker called WBRK_BROKER on a queue manager called WBRK_QM with a broker database that has the data source name WBRKBKDB, enter the following command:
    mqsicreatebroker WBRK_BROKER -i wbrkuid -a wbrkpw 
    -q WBRK_QM -n WBRKBKDB -u dbuid -p dbpw
    where:
    • wbrkuid and wbrkpw are the user name and password under which the broker will run.
    • dbuid and dbpw are the user name and password that the broker will use to access the broker database and create tables to store its internal data.

    If you want to add a User Name Server to your broker domain, create the broker with the additional -s and -j parameters on the mqsicreatebroker command. For more information, see Enabling a User Name Server.

    For more information about the command options, see mqsicreatebroker command.

You have now created and started a broker.
Next, you must perform the following tasks:
  1. Create any other components that you need.
  2. Create a WebSphere MQ infrastructure to connect the components together
  3. Add the broker to the broker domain:
When you have completed these tasks, the broker will be ready to use.
Related concepts
Brokers
Broker domains
Related tasks
Setting up a command environment
Creating a Configuration Manager
Creating a User Name Server
Adding a broker to a broker domain
Using WebSphere MQ trusted applications
Using the Command Assistant wizard
Related reference
mqsicreatebroker command
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:28

ae12720_ This topic's URL is: