本主题包含以下部分:
使用 MQOutput 节点将消息发送到使用 WebSphere MQ 企业传输方式 连接到代理并使用 MQI 和 AMI 应用程序编程接口的客户机。
MQOutput 节点将输出消息从消息流传递到 WebSphere MQ 队列。 该节点使用 MQPUT 将消息放入您指定的某个目的地队列。
如果恰当的话,您可以将队列定义为 WebSphere MQ 集群队列或共享队列。使用 WebSphere MQ 集群队列时,将队列管理器名留为空。
可配置 MQOutput 节点将消息放到可由代理的队列管理器访问的任何队列管理器上定义的特定 WebSphere MQ 队列。
可设置其他属性来通过设置相应的 MQPUT 选项控制发送消息的方法。例如,您可以请求在事务控制下处理的消息。如果适当,您还能指定 WebSphere MQ 可以在队列管理器中将 消息截为几段。
如果您创建的消息流将用作子流,则不能使用标准输出节点,您必须使用输出节点的实例来为传递消息的子流创建 out 终端。
如果不想让消息流将消息发送到 WebSphere MQ 队列,则可选择其他受支持的输出节点。
MQOutput 节点在工作台中由以下图标表示:
此处为可以如何使用此节点的示例,假定您已编写了一个常规的发布股票更新的发布应用程序。应用程序将消息发送到 MQInput 节点上的代理,并且消息流通过 Publication 节点使发布内容可用于多个订户。包含一个 MQOutput 节点以将消息发送到记录所发生的每个价格更改的应用程序。
当您将 MQOutput 节点的实例放入消息流后,便可对它进行配置。右键单击编辑器视图中的节点,然后单击属性。 将显示该节点的基本属性。
对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。
如下所示配置 MQOutput 节点:
如果您不想生成新的标识,则取消选中该复选框。请注意,如果在“属性”对话框“请求”面板中选中请求复选框,则仍会生成新的消息标识。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关此属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
有关这些属性映射到的选项的更多信息,在 WebSphere MQ Application Programming Reference 中提供。
请注意,即使没在属性对话框导航器的“高级”面板中选择新建消息标识复选框,也会生成新的消息标识。
单击取消以关闭对话框,并废弃对属性所作的所有更改。
当您定义 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 节点的“描述”属性。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |