TimeoutControl 节点

本主题包含以下部分:

用途

TimeoutControl 节点接收包含超时请求的输入消息。请参阅超时请求消息,获取超时请求消息的描述。该节点验证请求、存储消息,并将消息(不加更改)传播到消息流中的下一个节点。

TimeoutControl 节点在工作台中由以下图标表示:

超时控制节点图标

在消息流中使用此节点

对于要求事件在特定时间或固定时间间隔发生的应用情况,在消息流中同时使用 TimeoutControl 节点和 TimeoutNotification 节点。

以下是您可能要在消息流中使用超时节点的示例:
  1. 您需要在每天午夜运行批处理作业。
  2. 您希望有关货币兑换率的信息每小时发送到银行一次。
  3. 您想确认重要事务是否已在特定时间段内进行处理,并且当在该时间段内未处理某事务时,执行某些其他指定的操作来发出警告。

多个 TimeoutControl 节点可与一个 TimeoutNotification 节点配对。这些 TimeoutControl 节点处理的所有超时请求均由同一个 TimeoutNotification 节点处理。如果 TimeoutNotification 节点和每个 TimeoutControl 节点使用同一唯一标识,则会发生这种情况。

有关如何使用超时处理节点的更多详细信息,请查看超时处理样本

配置 TimeoutControl 节点

将 TimeoutControl 节点的实例放入消息流中后,可以对它进行配置。

右键单击编辑器视图中的节点,然后单击属性。将显示节点的基本属性。

唯一标识是唯一的必要属性。它没有缺省值。

通过执行以下操作,配置节点的基本属性:

  • 唯一标识中指定代理内唯一的标识。此标识应该和与其成对的 TimeoutNotification 节点中的同一个属性相同。此标识的最大长度为 12 个字符。
  • 请求位置中指定入局消息中超时请求信息的位置。此位置可以是输入消息树中的任何位置。如果不为此属性指定值,则假定为 InputLocalEnvironment.TimeoutRequest。请参阅超时请求消息,获取超时请求消息的描述。
  • 请求持久性指定值。此属性确定入局超时请求在代理或消息流(包含与此 TimeoutControl 节点成对的 TimeoutNotification 节点)重新启动后是否继续存在。如果想要入局请求持久,指定;如果不想要它持久,则指定。如果指定自动,则使用入局消息“属性”文件夹中的“持久性”设置。自动 是此属性的缺省值。

现在配置该节点的“消息”属性:

  • 存储的消息位置中指定您要存储的部分请求消息的位置,与此节点成对的 TimeoutNotification 节点将传播该部分请求消息。如果不指定值,将存储整个消息。您可以指定消息树中的任何有效位置。如果选择存储整个消息,则无需在消息域消息集消息类型消息格式中指定任何值。
  • 消息域中,从下拉列表中选择正在使用的解析器名称。当重新构建存储的消息用于传播时,与此节点成对的 TimeoutNotification 节点将使用此值和消息集消息类型以及消息格式中的三个相应值。如果已经存储了整个请求消息(通过将存储的消息位置保留为空白),请不要在此处指定任何值。如果选择存储部分请求消息,则必须在此处指定值,将所存储的请求消息片段反映为如同整个消息,当 TimeoutNotification 节点处理它时,情况正是如此。可以从下列名称中选择:
    • MRM
    • XML
    • XMLNS
    • XMLNSC
    • JMSMap
    • JMSStream
    • MIME
    • BLOB
    • IDOC
  • 如果您使用的是 MRM 或 IDOC 解析器,则从消息集中的下拉列表中选择正确的消息集。

    对于 XML、XMLNS、XMLNSC、JMS、MIME 和 BLOB 解析器,将消息集保留为空白。

  • 如果您使用的是 MRM 解析器,则从消息类型中的下拉列表中选择正确的消息。此列表是用所选的消息集中定义的消息填充的。

    对于 XML、XMLNS、XMLNSC、JMS、IDOC、MIME 和 BLOB 解析器,将消息类型保留为空白。

  • 如果您使用的是 MRM 或 IDOC 解析器,则从消息格式中的下拉列表中选择消息的格式。此列表包含您为此消息集定义的所有物理格式。

    对于 XML、XMLNS、XMLNSC、JMS、MIME 和 BLOB 解析器,将消息格式保留为空白。

完成配置时,单击应用。这在不关闭属性对话框的情况下就可以对 TimeoutControl 节点进行更改。单击确定以应用更改,并关闭属性对话框。单击取消以关闭对话框,并废弃对属性所作的所有更改。

终端和属性

下表中描述了 TimeoutControl 节点终端。

终端 描述
In 接受消息树用于进行处理(包括验证在消息树的请求位置中指定的超时请求)并将它添加到控制队列的输入终端。
Failure 如果在此节点中进行处理期间检测到故障,则将输入消息传播到的输出终端。如果此终端未连接到其他节点,则错误信息将传递回消息流中的前一个节点。
Out 在成功处理超时请求后,向其传播未经更改的入局消息的输出终端。如果此终端未连接到其他节点,则不会进行传播。如果消息传播失败,则消息将传播到 Failure 终端。

下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。

下表中描述了 TimeoutControl 节点的基本属性。

属性 M C 缺省值 描述
唯一标识 这是该节点的唯一必要属性。它的值在代理中必须是唯一的。与此节点成对的 TimeoutNotification 节点的等价属性必须具有相同的值。此标识的最大长度为 12 个字符。
请求位置 此属性描述在何处查找超时请求信息。这必须是消息树中的有效位置。运行时将验证此值。如果没有指定任何请求位置,将假定为 LocalEnvironment.TimeoutRequest。请参阅超时请求消息,获取超时请求消息的描述。
请求持久性 自动 此属性确定当代理或消息流重新启动后,入局超时请求是否继续存在。此属性的值可以是自动。如果该值为自动,则使用入局消息“属性”文件夹中的“持久性”设置。

下表中描述了 TimeoutControl 节点的消息属性。

属性 M C 缺省值 描述
存储的消息位置 要存储用于传播的部分请求消息的位置,与此节点成对的 TimeoutNotification 节点将传播该部分请求消息。
消息域 TimeoutNotification 节点将用来解析存储的超时请求消息的域。
消息集 消息集的名称或标识,其中定义了存储的超时请求消息。
消息类型 存储的超时请求消息的名称。
消息格式 存储的超时请求消息的物理格式的名称。

下表中描述了 TimeoutControl 节点的描述属性。

属性 M C 缺省值 描述
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
相关概念
消息流概述
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac20800_