本主题包含以下部分:
使用 MQOutput 节点将消息发送到使用 WebSphere MQ 企业传输方式 连接到代理并使用 MQI 和 AMI 应用程序编程接口的客户机。
MQOutput 节点将输出消息从消息流传递到 WebSphere MQ 队列。 该节点使用 MQPUT 将消息放入您指定的某个目的地队列或多个目的地队列。
如果恰当的话,您可以将队列定义为 WebSphere MQ 集群队列或共享队列。使用 WebSphere MQ 集群队列时,将队列管理器名留为空。
可配置 MQOutput 节点将消息放到可由代理的队列管理器访问的任何队列管理器上定义的特定 WebSphere MQ 队列,或放到与消息关联的 LocalEnvironment(也称为 DestinationList)中标识的目的地。
可设置其他属性来通过设置相应的 MQPUT 选项控制发送消息的方法。例如,您可以请求在事务控制下处理的消息。如果适当,您还能指定 WebSphere MQ 可以在队列管理器中将 消息截为几段。
如果您创建的消息流将用作子流,则不能使用标准输出节点,您必须使用输出节点的实例来为传递消息的子流创建 out 终端。
如果不想让消息流将消息发送到 WebSphere MQ 队列,则可选择其他受支持的输出节点。
MQOutput 节点在工作台中由以下图标表示:
当您将 MQOutput 节点的实例放入消息流后,便可对它进行配置。右键单击编辑器视图中的节点,然后单击属性。 将显示该节点的基本属性。
对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。
如下所示配置 MQOutput 节点:
如果您不想生成新的标识,则取消选中该复选框。请注意,如果在“属性”对话框“请求”面板中选中请求复选框,则仍会生成新的消息标识。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关这些属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
请注意,即使没在属性对话框导航器的“高级”面板中选择新建消息标识复选框,也会生成新的消息标识。
有关更多详细信息,请参阅验证消息和MRM 域中消息的验证属性。
单击取消以关闭对话框,并废弃对属性所作的所有更改。
将 in 终端连接到出站消息绑定所流出的节点。
如果您要进一步处理消息、处理错误或将消息发送到其他目标,则将此节点的 out 或 failure 终端连接到此消息流中的另一个节点。
如果您将这些输出终端中的某个终端连接到消息流中的另一个节点,则与消息关联的 LocalEnvironment 通过每个目标(消息已由此节点放入目标)的以下信息获得增强:
这些值写入 LocalEnvironment 树结构内的 WrittenDestination。
如果两个终端都没有连接,则未更改 LocalEnvironment 树。
如果您在消息流中使用聚集,则必须使用 out 终端。
当您定义 MQOutput 节点时,您为事务方式属性选择的选项会定义是否在同步点下编写消息:
MQOutput 节点的另一个属性,持久性方式,定义在将输出消息放到输出队列时是否将它标记为持久:
在以下表中描述了 MQOutput 节点终端。
终端 | 描述 |
---|---|
In | 接受供节点处理的消息的输入终端。 |
Failure | 当将消息放置到输出队列时如果检测到故障,则这是消息路由到的输出终端。 |
Out | 如果成功地将消息放到输出队列,并且在此消息流内要求进一步处理,则这是消息路由到的输出终端。 |
下表描述该节点的属性;标题为 M 的列表示属性是否是必需的(如果在未定义缺省值时必须输入值,则在属性对话框上以星号作标记),标题为 C 的列表示属性是否是可配置的(将消息流添加到 BAR 文件以部署此文件时可以更改该值)。
下表描述 MQOutput 节点的“基本”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
队列管理器名 | 否 | 是 | WebSphere MQ 队列管理器的名称,队列名中指定的输出队列定义到该队列管理器。 | |
队列名 | 否 | 是 | 该节点放入消息(使用 MQPUT)的 WebSphere MQ 输出队列的名称。 |
下表描述 MQOutput 节点“高级”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
目的地方式 | 是 | 否 | 队列名 | 输出消息发送到的队列。有效值为目的地列表、应答队列和队列名。 |
事务方式 | 是 | 否 | 自动 | 是否事务性地放入了消息。有效值为自动、是和否。 |
持久性方式 | 是 | 否 | 自动 | 是否持久地放入了消息。有效值为自动、是、否和按为队列定义。 |
新消息标识 | 是 | 否 | 已清除 | WebSphere MQ 是否生成新消息标识来替换 MQMD 中 MsgId 字段的内容。如果您选中该复选框,则执行此操作。 |
新建相关标识 | 是 | 否 | 已清除 | WebSphere MQ 是否生成新的相关标识来替换 MQMD 中 CorrelId 字段的内容。如果您选中该复选框,则执行此操作。 |
允许分段 | 是 | 否 | 已清除 | 如果合适,WebSphere MQ 可在队列管理器中将消息进行分段。如果您选中该复选框,则执行此操作。 |
消息上下文 | 是 | 否 | 全部传递 | 如何处理原始上下文。有效值为传递身份、全部设置、设置身份和缺省。 |
备用用户权限 | 是 | 否 | 已清除 | 在放入输出消息时是否使用备用权限。如果您选中该复选框,则执行此操作。 |
在以下表中描述了 MQOutput 节点请求属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
请求 | 是 | 否 | 已清除 | 是否将每个输出消息生成为请求消息。如果您选中该复选框,则执行此操作。 |
应答队列管理器 | 否 | 是 | WebSphere MQ 队列管理器的名称,应答队列中指定的输出队列定义到该队列管理器。 | |
应答队列 | 否 | 是 | WebSphere MQ 队列的名称,对该请求的应答将放入该队列。 |
下表描述 MQOutput 节点的“验证”属性。
请参阅MRM 域中消息的验证属性,以获取这些属性的完整描述。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
验证 | 是 | 是 | 继承 | 验证是否发生。有效值为无、内容和值、内容和继承。 |
故障操作 | 是 | 否 | 异常 | 验证失败后将发生什么操作。只有将验证设置为内容或内容和值,才可以设置该属性。有效值为用户跟踪、本地错误日志、异常和异常列表。 |
包含所有值约束 | 是 | 否 | 选中 | 无法编辑此属性。所选的复选框指出的缺省操作,即内容和值验证中包含的基本值约束检查。 |
固定 | 是 | 否 | 无 | 无法编辑此属性。 |
下表描述 MQOutput 节点的“描述”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |