AggregateReply 节点

使用 AggregateReply 节点来标记聚集扇入结束。 该节点收集应答并将其组合成单个复合消息。

有关进行中消息的状态的信息保存在由 IBM® MQ控制的存储队列上。 如果要在集成节点管理的集成服务器上使用聚集,那么必须在与集成节点相同的计算机上安装 IBM MQ ,以便使用 AggregateReply 节点提供的功能。 用于存放状态信息的存储队列由与集成节点相关联的队列管理器所有。

如果要在独立集成服务器上使用聚集,那么可以使用远程缺省队列管理器来控制系统队列,而无需在与集成服务器相同的机器上安装 IBM MQ 。 独立集成服务器与 IBM MQ 之间的交互可以使用缺省策略设置来使用与远程队列管理器的客户机连接。 有关使用远程缺省队列管理器的更多信息,请参阅 使用远程缺省队列管理器配置集成服务器以使用远程缺省队列管理器

有关 AggregateReply 节点所需的队列的更多信息,请参阅 配置聚集节点的事件存储

本主题包含以下几部分:

用途

聚集是请求/应答模型的扩展。 它将大量相关请求的生成和扇出与相应应答的扇入结合起来,并将那些应答编译成单个聚集的应答消息。

聚集函数由以下三个节点提供:

  • AggregateControl 节点标记属于聚集的扇出请求的开始。 它发送 AggregateReply 节点用于匹配已发出的不同请求的控制消息。 从 Control 终端传播的信息包括 集成服务器 标识,聚集名称属性和超时属性。 不得更改 AggregateControl 节点添加到消息环境的聚集信息。
  • AggregateRequest 节点记录已发送请求消息的事实。 它还收集有助于 AggregateReply 节点构造聚集应答消息的信息。 必须保留 AggregateRequest 添加到消息环境的信息,否则聚集将失败。
  • AggregateReply 节点标记聚集扇入的结束。 它收集应答并将其组合成单个聚集的应答消息。

AggregateReply 节点包含在选用板的 路由 抽屉中,并通过以下图标在 IBM App Connect Enterprise Toolkit 中表示:

AggregateReply 节点图标

AggregateReply 节点在接收到聚集的所有响应之前存储入局消息时,消息的持久性将确定是否在重新启动期间保留消息。

如果在聚集期间, AggregateReply 节点未接收到一条或多条响应消息,那么正常超时或未知消息处理将处理已接收到的响应。

在复合输出消息中,每个 AggregateReply 消息的 MQMD.Expiry 值都设置为 -1 。 设置此值的原因是,一旦应答消息不再位于 IBM MQ 传输上并且已由 集成服务器 在聚集过程中存储,那么 MQMD.Expiry 值就没有意义。

终端和属性

AggregateReply 节点的实例放入消息流后,可以对其进行配置; 请参阅 配置消息流节点。 节点的属性在“属性”视图中显示。 所有必须输入值(未定义缺省值)的必需属性用星号标记。

下表描述了 AggregateReply 节点终端。

终端 描述
输入 接受节点处理的消息的输入终端。
失败 如果在消息处理期间检测到故障,则将消息路由到此输出终端。
未知 输出终端,如果无法将消息标识为有效的应答消息,消息将路由到此终端。
输出 输出终端,成功完成处理之后,复合消息将路由到此终端。
Timeout 当相应 AggregateControl 节点中指定的超时时间间隔到期时,将不完整复合消息路由到的输出终端。
捕获 输出终端,如果下游抛出异常并被此节点捕获到,消息将路由到此终端。

下表描述了此节点的属性。 标题为 M 的列指出属性是否为必需(如果未定义缺省值时您必须输入值,那么将以星号标记);标题为 C 的列指出属性是否可配置(将消息流添加到 BAR 文件以进行部署时可以更改此值)。

下表描述了 AggregateReply 节点的 "描述" 属性。

属性 M C 缺省 描述
节点名 节点类型 (AggregateReply) 节点的名称。
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。

下表描述了 AggregateReply 节点的 "基本" 属性。

属性 M C 缺省 描述 mqsiapplybaroverride 命令属性
聚集名   用于将扇入消息流与扇出消息流相关联的名称。 此值在 集成服务器中必须是上下文唯一的。

此名称还用于标识要由节点使用的聚集策略 (如果存在) (请参阅 聚集策略)。 按 {policyProjectName}:PolicyName 格式指定策略项目和策略的名称。

aggregateName
未知的消息超时 0 在将无法识别为应答的消息传播到 Unknown 终端之前所拥有的时间(秒)。

缺省值为零;如果接受此缺省值,那么将禁用超时,并且在收到未知消息时会将其传播到 Unknown 终端。

 
事务方式 选中 此属性定义此消息的事务性特征:
  • 如果选中此复选框(缺省情况下是选中的),后继消息流将受事务控制。 对于从输出消息派生并由 MQOutput 节点生成的消息,此设置保持为 true ,除非 MQOutput 节点显式覆盖事务状态。 其他任何节点都不能更改此输出消息的事务特征。
  • 如果您不选中此复选框,后继消息流将不受事务控制。 对于从输出消息派生并由 MQOutput 节点生成的消息,此设置保持为 true ,除非 MQOutput 节点指定必须将消息置于同步点下。
 
下表描述了节点的“监视”属性。
属性 M C 缺省 描述
事件 为节点定义的事件显示在此选项卡上。 缺省情况下,不会在消息流中的任何节点上定义任何监视事件。 使用 添加编辑删除 来创建,更改或删除节点的监视事件。

通过选中或取消选中启用复选框,可以启用或禁用此处显示的事件。