Creating a broker

Before you start:

You must complete the following tasks:
  • Ensure that your ID has the correct authorizations to perform the task. Refer to Security requirements for administrative tasks.
  • For platforms other than z/OS, see Considering security for a broker for information about security matters relevant to a broker during the configuration task.
  • Create and configure the broker database. Configure ODBC to allow the broker to access its database. Refer to Configuring component databases for information on all these tasks.
  • Create a new user ID to access the broker database tables (persistent store).
  • If you want to configure a broker on Windows, UNIX systems, or Linux as a WebSphere MQ trusted application, refer to Using WebSphere MQ trusted applications before creating the broker. Using trusted (fastpath) applications allows the broker and the WebSphere MQ queue manager agent to run in the same process, thus improving overall performance.
  • 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. These parameters allow the broker to communicate with the User Name Server. See Enabling a User Name Server for details of the parameters to specify.
  • On Windows, UNIX systems, and Linux, you must set up your command-line environment before creating a broker, by running the product profile or console; refer to Setting up a command environment.
  • On Windows, UNIX systems, and Linux, you must set up any required database profiles, for example, running db2profile for DB2.

Create a broker using the command line on the system where the broker component is installed. On Windows, you can also use the Command Assistant to complete this task.

The broker must be given a name that is unique within the broker domain. Broker names are case-sensitive on all supported platforms, except the Windows platforms. The broker's name and its queue manager name are required when creating the broker reference in the workbench.

To create a broker, follow the link for the appropriate platform:

Related concepts
Brokers
Broker domains
Related tasks
Configuring component databases
Using WebSphere MQ trusted applications
Modifying a broker
Deleting a broker
Using the Command Assistant wizard
Considering security for a broker
Related reference
mqsicreatebroker command
Security requirements for administrative tasks