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

Configuring the storage of events for aggregation nodes

You can use an Aggregation configurable service to control the storage of events for AggregateControl and AggregateReply nodes.

By default, the storage queues used by all aggregation nodes are:
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.AGGR.TIMEOUT

However, you can control the queues that are used by different aggregation nodes by creating alternative queues containing a QueuePrefix, and using an Aggregation configurable service to specify the names of those queues for storing events.

Follow these steps to specify the queues that are used to store event states, and to set the expiry time of an aggregation:

  1. Create the storage queues to be used by the aggregation nodes. The following queues are required:
    • SYSTEM.BROKER.AGGR.QueuePrefix.CONTROL
    • SYSTEM.BROKER.AGGR.QueuePrefix.REPLY
    • SYSTEM.BROKER.AGGR.QueuePrefix.REQUEST
    • SYSTEM.BROKER.AGGR.QueuePrefix.UNKNOWN
    • SYSTEM.BROKER.AGGR.QueuePrefix.TIMEOUT

    The QueuePrefix variable can contain any characters that are valid in a WebSphere® MQ queue name, but must be no longer than eight characters and must not begin or end with a period (.). For example, SET1 and SET.1 are valid queue prefixes, but .SET1 and SET1. are invalid.

    If you do not create the storage queues, WebSphere Message Broker creates the set of queues when the node is deployed; these queues are based on the default queues. If the queues cannot be created, the message flow is not deployed.

  2. Use the mqsicreateconfigurableservice command to create an Aggregation configurable service. You can create a configurable service to be used with either a specific aggregation or with all aggregations in an execution group.
    1. If the configurable service is to be used with a specific aggregation, ensure that the name of the configurable service is the same as the name that you specify in the Aggregate name property on the AggregateControl and AggregateReply nodes. If the configurable service is to be used with all aggregations in an execution group, create the configurable service with the same name as the execution group.
    2. Set the Queue prefix property to the required value.
    3. Optional: Set the Timeout property to control the expiry time of an aggregation.
    For example, create a configurable service called myAggregation, which specifies queues prefixed with SYSTEM.BROKER.AGGR.SET1 and a timeout of 60 seconds:
    mqsicreateconfigurableservice MYBROKER -c Aggregation -o myAggregation 
    -n queuePrefix,timeoutSeconds -v SET1,60 

    You can use the mqsideleteconfigurableservice command to delete the Aggregation configurable service. However, the storage queues are not deleted automatically when the configurable service is deleted, so you must delete them separately.

    For more information, see Configurable services properties
  3. In the AggregateControl and AggregateReply nodes:
    1. Ensure that the name of the Aggregation configurable service is the same as the name specified in the Aggregate name property on the Basic tab; for example, myAggregation. If no Aggregation configurable service exists with the same name as the Aggregate name property, and if a configurable service exists with the same name as the execution group, that configurable service is used instead.
    2. Optional: Use the mqsichangeproperties and mqsireportproperties commands to change or view the properties of the configurable service. Alternatively, you can use the WebSphere Message Broker Explorer to view or modify a configurable service. For more information about working with configurable services, see Using the WebSphere Message Broker Explorer to work with configurable services.
The properties for the configurable service are not used by the broker until you restart or redeploy the message flow, or restart the broker.
Notices | Trademarks | Downloads | Library | Support | Feedback

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

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:52


Task topicTask topic | Version 8.0.0.7 | bc28130_