WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Creating a broker on Linux and UNIX systems

On Linux and UNIX systems, create brokers on the command line; on Linux on x86, you can also create brokers in the WebSphere® Message Broker Toolkit.

Before you start:

When you create a broker, if the WebSphere MQ queue manager does not exist, the queue manager is automatically created. If WebSphere MQ Version 7.1, or later, has been selected for the queue manager, the channel auth security is automatically disabled.

If the specified queue manager already exists when creating the broker, then it is assumed that the user has applied the appropriate security configuration to meet their requirements, and therefore channel auth security is not disabled.

To create a broker:

  1. Ensure that you are logged in using a user ID that has authority to run the mqsicreatebroker command.
  2. Run the mqsiprofile script to set up the command environment for the broker:
    . install_dir/bin/mqsiprofile

    You must run this script before you can run the WebSphere Message Broker commands.

    For more information, see Setting up a command environment.

  3. The command mqsicreatebroker defaults to using the primary installation of WebSphere MQ, if present, for the creation of queue managers. If you want to use a non-primary installation of WebSphere MQ you must configure your environment by using the setmqenv script before running the mqsicreatebroker command. For more details see: WebSphere MQ Version 7.1 setmqenv.

    If you are creating a broker on a queue manager that already exists, there is no need to configure your WebSphere MQ environment.

  4. Use the mqsicreatebroker command to create the broker.
    For example, if you want to create a broker called MB8BROKER on a queue manager called MB8QMGR, enter the following command:
    mqsicreatebroker MB8BROKER -q MB8QMGR

    When you create a broker, the web user interface starts automatically on port 4414. You can disable the web user interface or change the port on which it runs by using the mqsichangeproperties command. If administration security is not enabled, web users can access the web user interface as a default user with unrestricted access to data and broker resources.

  5. To enable function that becomes available in WebSphere Message Broker fix packs, use the -f parameter on the mqsichangebroker command. For more information, see mqsichangebroker command.
You have created a broker.

Next: Complete the following tasks:

  1. Start the broker by using the mqsistart command.
  2. Connect to the broker from the WebSphere Message Broker Toolkit, the WebSphere Message Broker Explorer, or a CMP API application.

When you have completed these tasks, you can create the resources that you want to associate with the broker; for example message flows. You can create and work with resources by using either the WebSphere Message Broker Toolkit or the CMP API.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:46:57


Task topicTask topic | Version 8.0.0.7 | ae12680_