WebSphere Message Brokers
File: ac37020_
Writer: Karen Cameron

Task topic

This build: July 31, 2007 21:20:38

Configuring a broker environment to use WebSphere MQ for aggregation nodes

By default, all execution groups use a database table for storing aggregation requests. If you prefer to use WebSphere MQ to store aggregation requests, set the MQSI_AGGR_MQ environment variable. Use this variable to list the execution groups that use WebSphere MQ instead of a database. The format of the value of the variable is:
<List of Brokers>/<List of Execution groups>
where <List of Brokers> is a comma-separated list of brokers to use, and <List of Execution groups> is a comma-separated list of execution groups. If an execution group is running under a broker in the list and has an entry in the execution list, it uses WebSphere MQ to store state for aggregations. You can use an asterisk (*) as a wildcard in either the <List of Brokers> or the <List of Execution groups>. If the wildcard appears in the list, any broker or execution group is matched. The following table includes some examples that show how to use the MQSI_AGGR_MQ variable:
Value Result
*/* All execution groups on the computer are enabled.
BROKER1/* All execution groups running on BROKER1 are enabled.
*/default All execution groups called "default" are enabled.
BROKER1/default,eg1,eg2 Execution groups called "default", "eg1", and "eg2" on BROKER1 are enabled.
BROKER1,BROKER2/default,eg1,eg2 Execution groups called "default", "eg1", and "eg2" on BROKER1 and on BROKER2 are enabled.

To create the MQSI_AGGR_MQ variable and configure it to use WebSphere MQ to store aggregation state:

Windows:

  1. Open the System properties by clicking Start > Control Panel > System.
  2. Click the Advanced tab.
  3. Click Environment Variables.
  4. In the System variables pane, click New.
  5. Under Variable name, enter MQSI_AGGR_MQ.
  6. Set the value of the variable to specify which execution groups use WebSphere MQ (refer to the examples in the table).
  7. Restart the computer.
Linux and UNIX:
  1. Edit the profile of the broker user ID and refer to the examples in the table to set the value of the MQSI_AGGR_MQ variable:
    export MQSI_AGGR_MQ=value
  2. Reload the profile.
  3. Restart the broker.
z/OS:
  1. Edit the broker ENVFILE and refer to the examples in the table to set the value of the MQSI_AGGR_MQ variable:
    MQSI_AGGR_MQ=value
  2. Reload the profile.
  3. Restart the broker.
Related concepts
Message flows overview
Message flow aggregation
Related tasks
Using WebSphere MQ to store state in aggregation nodes
Migrating a broker for use with aggregation nodes
Configuring a broker environment to send control messages
Configuring aggregation flows
Developing message flows
Designing a message flow
Creating a message flow
Defining message flow content
Related reference
AggregateControl node
AggregateReply node
AggregateRequest node
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:20:38

ac37020_ This topic's URL is: