“MQ 放置消息”活动

在运行时期间,可以使用 MQ 放置消息活动向指定队列发送消息。

注: 在配置该活动之前,您必须已经为 MQ 活动创建端点
配置任务包含三个部分:

完成配置任务后,针对活动进行映射输入

注: 最大消息大小为 100 MB。

队列和消息详细信息

使用下表中的字段指定队列和消息详细信息。 必填字段以星号标记。
字段 描述
队列名称 * 指定队列的名称(会将消息放入该队列中)。
有效内容数据类型 指定消息有效内容的数据类型:二进制字符串
消息类型 数据报 - 选择是否应发送消息以及是否不需要答复。

请求 - 选择消息是否应有答复。确保为请求消息设置“答复队列”属性。

响应 - 选择消息是否为对先前请求的答复。

答复队列 指定应将请求消息的答复发送到的队列。
答复队列管理器 指定队列(在答复队列字段中指定)所属于的队列管理器的名称。
持久
  • True - 如果队列管理器崩溃,那么会将消息恢复到队列。
  • False - 如果队列管理器崩溃,那么队列中的消息可能会丢失。
  • Default - 消息为队列使用持久性设置(这是缺省值)。
优先级 指定消息的优先级。缺省情况下,消息优先级缺省为队列的缺省优先级。如果队列使用优先级来排列消息并且此消息应已具有特定优先级设置,那么请选择指定并输入优先级。优先级的范围可以从 1(最低)到 9(最高)。
注: 优先级不应超过为 MQ 队列设置的最大优先级号。请与 MQ 系统管理员核实此信息。
消息到期 消息在到期之前保留在队列中的秒数。缺省值为 Never,这可确保消息得到交付并且在队列中等待至被检索,无论需要多长时间。

如果此队列的消息应过期,并且应在一定时间段后抛弃,请选择指定,并输入消息应在队列中保留的最大秒数。

MQRFH2 头的模式片段 指定 MQRFH2 头是否包含在消息中。 如果消息是 XML 消息并且包含 MQRFH2 头,那么请选中此复选框并单击 [...]。在浏览至模式类型元素对话框中,找到用于定义头的 XML 模式,在该 XML 模式中选择 NameValueData 元素,然后单击确定。模式片段为 NameValueData 元素及其所有子元素。 
注: 必须首先创建用于定义头的 XML 模式,并将其装入到项目中,然后才能选择该 XML 模式。有关更多信息,请参阅为 MQRFH2 头定义和装入 XML 模式

交付规则

字段 描述
交付消息 此处的可用选项包括:
  • 至少一次 - 指定至少交付消息一次,但是可能会多次交付。连接或 Integration Appliance 故障可能会导致多次检索和处理消息。此交付选项通常在接收系统可以检测到或允许重复消息时使用。
  • 至多一次 - 指定仅交付消息一次或根本不交付消息。连接或 Integration Appliance 故障可能会导致丢失消息。此交付选项通常在接收系统不允许重复消息但是允许丢失消息时使用。

重试选项

配置用于连接到 MQ 服务器的重试选项。下表描述用于连接到 MQ 服务器的重试选项:

重试选项 描述
1) 在前后两次重试之间等待 __ 秒。 Integration Appliance 在再次尝试联系队列管理器以向 MQ 服务器发送消息之前要等待的秒数。
2) 失败之前的连接尝试次数。 指定 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试联系队列管理器以向 MQ 服务器发送消息的最大次数。

如果部署了包含 MQ 放置消息活动的编排,而且 Integration Appliance 无法连接指定 MQ 服务器的队列管理器,那么 Integration Appliance 会将错误以警告的形式记录在系统和编排日志中,直至达到重试计数值。在达到重试计数后,Integration Appliance 会在系统和编排日志中记录错误,并停止处理当前编排作业。

例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将以错误形式记录第四个错误,并停止处理当前编排作业。

映射输入

您需要为此活动映射输入参数。以下参数是必需的;而且,要完成配置,就必须映射这些参数。所有其他参数均为可选。请参阅创建映射以获取更多信息。
必需的输入参数:
payload

要在映射输入面板的目标活动面板中查看可选输入参数,请从工具栏菜单中选择映射 > 显示可选参数,或在目标活动面板中右键单击并选择显示可选参数选项。如果无法在工具栏菜单中选择映射 > 显示可选参数选项,那么请单击映射输入面板中的节点以激活此选项。




反馈 | 声明


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/MQ_Put_Message_Activity.html