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.
  • Start of changeFor platforms other than z/OS, see Considering security for a broker for information about security matters relevant to a broker during the configuration task.End of change
  • 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.
  • Start of changeOn 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. End of change
  • Start of changeOn Windows, UNIX systems, and Linux, you must set up any required database profiles, for example, running db2profile for DB2. End of change

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

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
Start of changeUsing the Command Assistant wizardEnd of change
Considering security for a broker
Related reference
mqsicreatebroker command
Security requirements for administrative tasks