WebSphere Message Brokers
File: ac37030_
Writer: Karen Cameron

Task topic

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

Configuring a broker environment to send control messages

By default, when you use WebSphere MQ to store state, any connections from the control terminal of the AggregateRequest node to the AggregateReply node are ignored. For these connections to be active, create the MQSI_AGGR_COMPAT_MODE environment variable in the broker's environment. By default, the environment variable does not exist. When you create this environment variable, connections from the AggregateControl node are active, regardless of the value of the environment variable.

When the MQSI_AGGR_COMPAT_MODE environment variable has not been created, the default behavior for aggregation fan-out flows is used. If the control terminal of the AggregateControl node is connected to the in terminal of the AggregateReply node, either directly or indirectly, this connection is ignored and no control message is sent.

If the MQSI_AGGR_COMPAT_MODE environment variable is created, the default behavior for aggregation fan-out flows is not used, allowing you to send control messages from the AggregateControl node to the AggregateReply node, but this configuration might have an adverse effect on performance.

To create the MQSI_AGGR_COMPAT_MODE variable to allow connections between AggregateControl and AggregateReply nodes to be recognized:

Windows:

  1. Open the System properties by clicking Start > Control Panel > System.
  2. Click the Advanced tab.
  3. Click Environment Variables.
  4. On the System variables pane, click New.
  5. Under the Variable name, enter MQSI_AGGR_COMPAT_MODE.
  6. Optional: Enter the variable value.
  7. Restart the computer.
Linux and UNIX:
  • Edit the profile of the broker user ID and include the following information:
    export MQSI_AGGR_COMPAT_MODE=true
  • Reload the profile.
  • Restart the broker.
z/OS:
  • Edit the profile ENVFILE and include the following information:
    MQSI_AGGR_COMPAT_MODE=true
  • 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 use WebSphere MQ for aggregation nodes
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:39

ac37030_ This topic's URL is: