Configurable message flow properties

When you add a message flow to a broker archive (bar) file in preparation for deploying it to a broker, you can set additional properties that influence its runtime operation. These properties are available for review and update when you select the Configure tab for the broker archive file.

Additional Instances
Specifies the number of additional threads that the broker can use to service the message flow. These additional threads are created only if there are sufficient input messages. You can have up to 256 threads. The default value is 0. Additional threads can increase the throughput of a message flow but you should consider the potential impact on message order.

If the message flow processes WebSphere MQ messages, you can configure the message flow to control the message order. Set the Order Mode property on the MQInput node accordingly. You might also need to set the Commit by Message Group and Logical Order properties.

The broker opens the input queue as shared (using the MQOO_INPUT_SHARED option), so you must ensure that the input queue has been defined with the SHARE property to enable multiple broker threads to read from the same input queue.

For more information about the node properties, refer to the MQInput node.

Commit Count
Specifies how many input WebSphere MQ messages are processed by a message flow before a syncpoint is taken (by issuing an MQCMIT).

Set this property only if you have set Additional Instances to 0.

The default value of 1 is also the minimum permitted value. Change this property to avoid frequent MQCMIT calls when messages are being processed quickly and the lack of an immediate commit can be tolerated by the receiving application.

Use the Commit Interval to ensure that a commit is performed periodically when not enough messages are received to fulfill the Commit Count.

This property has no effect if the message flow does not process WebSphere MQ messages.

Commit Interval
For WebSphere MQ messages, specifies a time interval at which a commit is taken when the Commit Count property is greater than 1 (that is, where the message flow is batching messages), but the number of messages processed has not reached the value of the Commit Count property. It ensures that a commit is performed periodically when not enough messages are received to fulfill the Commit Count.

The time interval is specified in seconds , as a decimal number with a maximum of 3 decimal places (millisecond granularity). The value must be in the range 0.000 through 60.000. The default value is 0.

Set this property only if you have set Additional Instances to 0.

This property has no effect if the message flow does not process WebSphere MQ messages.

You can view and update other configurable properties for the message flow. The properties that are displayed depend on the nodes within the message flow; some have no configurable properties to display. The node properties that are configurable are predominantly system-related properties that are likely to change for each broker to which the message flow is deployed. These properties include the names of WebSphere MQ queues and queue managers. For full details of configurable properties for a node, see the appropriate node description.

Related concepts
Message flows overview
Deployment overview
Related tasks
Developing message flows
Editing configurable properties
Related reference
Built-in nodes