IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Configuring the storage of events for timeout nodes

You can use a Timer configurable service to control the storage of events for TimeoutNotification and TimeoutControl nodes.

By default, the storage queue used by all timeout nodes is the SYSTEM.BROKER.TIMEOUT.QUEUE.

However, you can control the queues that are used by different timeout nodes by creating alternative queues that contain a QueuePrefix variable, and by using a Timer configurable service to specify the names of those queues for storing events.

Follow these steps to specify the queue that is used to store event states:

  1. Create the storage queue to be used by the timeout nodes. The following queue is required:
    • SYSTEM.BROKER.TIMEOUT.QueuePrefix.QUEUE

    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 queue, IBM® Integration Bus creates the queue when the node is deployed; this queue is based on the default queue. If the queue cannot be created, the message flow is not deployed.

  2. Use the mqsicreateconfigurableservice command to create a Timer configurable service. You can create a configurable service to be used with either specific timeout requests or with all timeout requests in an integration server.
    1. If the configurable service is to be used with specific timeout requests, create the configurable service with the same name as the Unique identifier property on the TimeoutNotification and TimeoutControl nodes. If the configurable service is to be used with all timeout requests in an integration server, create the configurable service with the same name as the integration server. However, the name of a configurable service cannot start with a digit; if the name of the configurable service is to be the same as that of the integration server, ensure that the name of the integration server does not start with a digit.
    2. Set the Queue prefix property to the required value.
    For example, create a Timer configurable service that uses a queue prefixed with SYSTEM.BROKER.TIMEOUT.SET1:
    mqsicreateconfigurableservice IB9NODE -c Timer -o myTimer 
    -n queuePrefix -v SET1 

    You can use the mqsideleteconfigurableservice command to delete the Timer configurable service. However, the storage queue is not deleted automatically when the configurable service is deleted, so you must delete it separately.

    For more information, see Configurable services properties.
  3. In the TimeoutNotification and TimeoutControl nodes:
    1. Ensure that the name of the Timer configurable service is the same as the name specified in the Unique Identifier property on the Basic tab; for example, myTimer. If there is no Timer configurable service with the same name as the Unique Identifier, and if there is a configurable service with the same name as the integration server, 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 IBM Integration Explorer to view or modify a configurable service. For more information about working with configurable services, see Using the IBM Integration 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.

bc28150_.htm | Last updated Friday, 21 July 2017