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 the profile supplied in the broker samples directory (located in /usr/opt/mqsi/sample/profiles/profile.aix). The profile sets up the environment with the required locale variables.
    1. Enter the following command:
      . /usr/opt/mqsi/sample/profiles/profile.aix
  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 Business Integration Event 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 using the workbench (Adding a broker to a broker domain).

Related concepts
Broker
Broker domain

Related tasks
Adding a broker to a broker domain

Related reference
mqsicreatebroker command