DestinationData 子树是 LocalEnvironment 中的 Destination 子树的一部分。LocalEnvironment 树是由输入节点(当它们收到消息时)创建的,或者是由 Compute 节点创建的(可选)。它们在创建时为空,但是您可以使用任何 SQL 节点中的 ESQL 语句在其中创建数据。
目标子树由零个或多个协议(例如,WebSphere MQ 和 WebSphere MQ Everyplace)的子树和/或路由目的(RouterList)组成。
协议树有两个子代:
LocalEnvironment 树结构 包含典型树的图片,显示了包含协议树和 RouterList 子树的目标树。
DestinationData 文件夹中的数据结构与相同协议的 Defaults 中的数据结构相同,而且可以用来越过 Defaults 中的缺省值。因此,您可以设置缺省值以包含对于所有目标是公共的值,并仅在每个 DestinationData 子树中设置唯一的值。如果值未在DestinationData 中和 Defaults 中设置,则使用您已为相应节点设置的值。
用于WebSphere MQ 的 Defaults 和 DestinationData 子树的每个元素的字段、数据类型和有效值在下表中显示。MQOutput 节点描述相应的节点属性。
请参阅访问 LocalEnvironment 树以获取有关使用 DestinationData 的信息。
元素的数据类型 | 表示为 | 相应的节点属性 | 有效值 |
---|---|---|---|
queueManagerName | CHARACTER | 队列管理器名 | |
queueName | CHARACTER | 队列名 | |
transactionMode | CHARACTER | 事务方式 | no、yes、automatic |
persistenceMode | CHARACTER | 持久性方式 | no、yes、automatic、asQdef |
newMsgId | CHARACTER | 新消息标识 | 否,是 |
newCorrelId | CHARACTER | 新建相关标识 | 否,是 |
segmentationAllowed | CHARACTER | 允许分段 | 否,是 |
alternateUserAuthority | CHARACTER | 备用用户权限 | 否,是 |
replyToQMgr | CHARACTER | 应答队列管理器 | |
replyToQ | CHARACTER | 应答队列 |
当您在 DestinationData 文件夹中创建这些字段时,您需要准确输入表中显示的数据类型和值。如果拼写或大小写有任何不同那么将在 DestinationData 记录和下一个所使用的可用值中忽略这些字段。
例如,以下 ESQL 示例将导致异常输出:
SET OutputLocalEnvironment.Destination.MQ.DestinationData[1].persistenceMode = 'YES';
SET OutputLocalEnvironment.Destination.MQ.DestinationData[2].PersistenceMode = 'yes';
在每个例子中,DestinationData 文件加可能不会写这些目标的持久消息。在第一个例子中, 给予了 persistenceMode 字段“YES”值,这不是表中列出的有效值,此值将忽略。在第二个例子中,名为“PersistenceMode”指定错误且将忽略。将使用 Defaults 文件夹的 persistenceMode 值,或者 MQOutput 节点上相关属性的值。如果这导致要使用“no”或“automatic”值,将不会写持久消息。
如果 DestinationData 文件夹产生异常输出,您应该检查是否在字段和所用的值中使用了正确的大小写和拼写。