WebSphere Message Brokers
File: ac20800_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:19:26

TimeoutControl node

The TimeoutControl node receives an input message that contains a timeout request.

This topic contains the following sections:

Purpose

The TimeoutControl node validates the timeout request message, stores the message, and propagates the message (unchanged) to the next node in the message flow. For more information, see Timeout request message.

The TimeoutControl node is contained in the Timer drawer of the palette, and is represented in the workbench by the following icon:

Timeout Control node icon

Using this node in a message flow

Use a TimeoutControl node and a TimeoutNotification node together in a message flow for an application that requires events to occur at particular times, or at regular intervals.

These examples show when you would use the timeout nodes in a message flow:
  • You need to run a batch job every day at midnight.
  • You want information about currency exchange rates to be sent to banks at hourly intervals.
  • You want to confirm that important transactions are processed within a certain time period and perform some other specified actions to warn when a transaction has not been processed in that time period.

More than one TimeoutControl node can be used with a TimeoutNotification node. Timeout requests that are processed by those TimeoutControl nodes are all processed by the same TimeoutNotification node if the same Unique Identifier is used for the TimeoutNotification node and each of the TimeoutControl nodes.

Look at the following sample for more details about how to use the timeout processing nodes: You can view samples only when you use the information center that is integrated with the Message Brokers Toolkit.

Configuring the TimeoutControl node

When you have put an instance of the TimeoutControl node into a message flow, you can configure it; see Configuring a message flow node. The properties of the node are displayed in the Properties view.

All mandatory properties for which you must enter a value (those that do not have a default value defined) are marked with an asterisk.
  1. On the Basic tab, set the following properties:
    • In Unique Identifier, specify an identifier that is unique within the broker. This identifier should be identical to the same property in the TimeoutNotification node with which it is paired. The maximum length of this identifier is 12 characters. Unique Identifier is the only mandatory property; it does not have a default value.
    • In Request Location, specify the location of the timeout request information in the incoming message. This location can be anywhere in the input message tree. If you do not specify a value for this property, InputLocalEnvironment.TimeoutRequest is assumed. For more information about the timeout request message, see Timeout request message.
    • Specify a value for Request Persistence. This property determines whether incoming timeout requests survive a restart of either the broker or the message flow that contains the TimeoutNotification node that is paired with this TimeoutControl node. Select Yes if you want the incoming request to persist; select No if you do not. If you select Automatic, the default, the Persistence setting in the Properties folder of the incoming message is used.
  2. On the Message tab, set the following properties:
    • In Stored Message Location, specify the location of the part of the request message that you want to store for propagation by the TimeoutNotification node with which it is paired. If you do not specify a value, the entire message is stored. You can specify any valid location in the message tree. If you choose to store the entire message, you do not need to specify any values in Message Domain, Message Set, Message Type, or Message Format.
    • In Message Domain, select the name of the parser that you are using from the drop-down list. This value, and the three corresponding values in Message Set, Message Type, and Message Format, are used by the TimeoutNotification node with which it is paired when it rebuilds the stored message for propagation. If you have stored the entire request message (by leaving Stored Message Location blank), do not specify any values here. If you choose to store part of the request message, specify values here that reflect the stored request message fragment as if it were the entire message, which is the case when it is processed by the TimeoutNotification node. Choose from the following parsers:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • If you are using the MRM or IDOC parser, select the correct message set from the drop-down list in Message Set.

      Leave Message Set blank for XML, XMLNS, XMLNSC, JMS, MIME, and BLOB parsers.

    • If you are using the MRM parser, select the correct message from the list in Message Type. This list is populated with messages that are defined in the message set that you have selected.

      Leave Message Type blank for XML, XMLNS, XMLNSC, JMS, IDOC, MIME, and BLOB parsers.

    • If you are using the MRM or IDOC parser, select the format of the message from the list in Message Format. This list includes all the physical formats that you have defined for this message set.

      Leave Message Format blank for XML, XMLNS, XMLNSC, JMS, MIME, and BLOB parsers.

Terminals and properties

The TimeoutControl node terminals are described in the following table.

Terminal Description
In The input terminal that accepts a message tree for processing (which includes validating the timeout request specified in the message tree at Request Location) and adds it to the control queue.
Failure The output terminal to which the input message is propagated if a failure is detected during processing in this node. If this terminal is not connected to another node, error information is passed back to the previous node in the message flow.
Out The output terminal to which incoming messages are propagated, unchanged, after successful timeout request processing. If this terminal is not connected to another node, no propagation occurs. If propagation of the message fails, the message is propagated to the Failure terminal.

The following tables describe the node properties. The column headed M indicates whether the property is mandatory (marked with an asterisk if you must enter a value when no default is defined); the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the bar file to deploy it).

The Description properties of the TimeoutControl node are described in the following table.

Property M C Default Description
Node name No No The node type, TimeoutControl The name of the node.
Short Description No No   A brief description of the node.
Long Description No No   Text that describes the purpose of the node in the message flow.

The Basic properties of the TimeoutControl node are described in the following table.

Property M C Default Description
Unique Identifier Yes Yes  None This is the only mandatory property for the node. Its value must be unique within the broker. The equivalent property of the TimeoutNotification node with which it is paired must have the same value. The maximum length of this identifier is 12 characters.
Request Location No No None This property describes where to find the timeout request information. This value must be a valid location in the message tree and is validated at run time. If no request location is specified, LocalEnvironment.TimeoutRequest is assumed. For more information about the timeout request message, see Timeout request message.
Request Persistence No No Automatic This property controls whether an incoming timeout request survives a broker or message flow restart. Valid values are Automatic, Yes, or No. If the value is Automatic, the Persistence setting in the Properties folder of the incoming message is used.

The Message properties of the TimeoutControl node are described in the following table.

Property M C Default Description
Stored Message Location No No None The location of the part of the request message that you want to store for propagation by the TimeoutNotification node with which this node is paired.
Message Domain No No None The domain that is used to parse the stored timeout request message by the TimeoutNotification node.
Message Set No No None The name or identifier of the message set in which the stored timeout request message is defined.
Message Type No No None The name of the stored timeout request message.
Message Format No No None The name of the physical format of the stored timeout request message.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:19:27

ac20800_ This topic's URL is: