Creating a broker on AIX

If you expect your broker to handle a heavy load (running a large number of message flows, or interacting with a number of databases), it might exceed the default memory limits that you configured during AIX installation. If the broker experiences memory problems, check the maximum size of the data segment for the user under which your broker is running (the ServiceUserID), and consider increasing its value. The size is defined in /etc/security/limits.

To create a broker:

  1. Log on using your service user ID. If you use the su command to switch user you must ensure that you invoke that user's profile.
    1. Enter su - <user ID> to run a different user's profile.
  2. Run '. <install_dir>/bin/mqsiprofile' to source the mqsiprofile script and set up the environment for a single targeted runtime. You must do this before you can run any of the WebSphere Message Broker commands.
  3. Ensure that the broker database instance profile has been run. Invoke the SQL profile that was created when the broker database was created.
  4. Enter the following command to create the broker:
    mqsicreatebroker WBRK_BROKER -i wbrkuid -a wbrkpw
    -q WBRK_QM -n WBRKBKDB -u dbuid -p dbpw
    If you are using different names or values for any parameter on this command, you must replace the appropriate values with your own.
    In the command above:
    WBRK_BROKER
    Is the broker name.
    wbrkuid
    Is the service user ID that is used to run the broker.
    wbrkpw
    Is the password for the service user ID.
    WBRK_QM
    Is the name of the WebSphere MQ queue manager that the broker will use. This queue manager is created if it does not exist.
    WBRKBKDB
    Is the name of the existing broker database, the broker tables will be created within this database.
    dbuid
    Is the user ID that has read, write and create access permissions for the database. This is the user ID that will be used to read and update the broker's persistent store.
    dbpw
    Is the password that is associated with the database user ID, dbuid.
On completion of this task, you have:
Now that you have created a physical broker, you are ready to:
  1. Create and start the WebSphere MQ queue manager channels that are required to connect WebSphere Message Broker components (brokers, User Name Servers, and Configuration Manager). This allows components in your broker domain that are supported by different queue managers to exchange messages and communicate effectively. Refer to Connecting components.
  2. Add the broker to the broker domain.
Related concepts
Brokers
Broker domains
Related tasks
Adding a broker to a broker domain
Related reference
mqsicreatebroker command