Timer policy

Attach a Timer policy to one or more TimeoutControl or TimeoutNotification nodes in a message flow to control the storage of events at run time.

You use a TimeoutNotification node in a message flow to manage timeout-dependent message flows, and you use a TimeoutControl node to process an input message that contains a timeout request. Timeout request messages are stored for processing on a queue that is used by the Timer nodes. A default queue is used, but you can use a Timer policy to specify an alternative timeout queue, which provides greater control over the storage of messages. See Configuring the storage of events for timeout nodes.

To attach a Timer policy to a Timer node, set the Unique identifier property of the TimeoutControl or TimeoutNotification node to the name of the policy, in the format {policyProjectName}:policyName. When a policy is attached to the node, the policyName without the {policyProjectName}: prefix is used as the unique identifier.

To use the policy with all timeout requests in an integration server, create the policy with the name Default and deploy it in the default policy project to the integration server. All timer nodes with a blank Unique identifier property then use the values from this default Timer policy.

Deploy this policy before the associated message flow is started. If you redeploy a Timer policy, all message flows that are using the policy are stopped and restarted.

The properties of this policy are described in the following table.

Table 1. Properties of the Timer policy
Property	Property name in .policyxml file	Value
Queue prefix	queuePrefix	This property specifies the queue prefix that is used to specify the storage queue that is generated for use by the Timer nodes. If you set this property, you must specify the SYSTEM.BROKER.TIMEOUT.`QueuePrefix`.QUEUE queue. The prefix can contain any characters that are valid in an IBM® MQ queue name. However, the prefix must be no longer than eight characters and must not begin or end with a period (.). For example, `SET.1` is valid, but `.SET1` and `SET1.` are invalid. Multiple policies can use the same queue prefix. If no queue prefix is specified, the Timer nodes use the default queue that is generated when the integration server is created (SYSTEM.BROKER.TIMEOUT.QUEUE). The value type is String.
Timeout (seconds)	timeoutInterval	This mandatory property specifies the value that is used by the TimeoutNotification node to set the timeout interval (in seconds) when the node is running in automatic mode. The value can be any integer that is greater than one. The value of this property overrides the value set on the node, but it is ignored if the node is not running in automatic mode. The value type is Integer.