MQ MQPutMessageOptions介绍

MQSeries(R) 使用 Java(R)

---

---

MQPutMessageOptions

java.lang.Object | *- com.ibm.mq.MQPutMessageOptions

   

public class MQPutMessageOptions
extends Object

该类包含控制 MQQueue.put() 操作的选项。

注: 该类中可用的一些选项的操作取决于使用它们的环境。使用 * 来标记这些元素。请参阅 "在其它环境中运行的版本 5 扩展"以获取细节。

变量

options

public int options

控制 MQQueue.put 操作的选项。可以指定下列任何值，或不指定下列值。如果需要多个选项，可以使用按位“或”运算符添加或组合这些值。

MQC.MQPMO_SYNCPOINT

使用同步点控制放入消息。该消息在工作单元外部是不可见的，直到落实工作单元为止。 如果工作单元被逆序（现场）恢复，那么将删除消息。

MQC.MQPMO_NO_SYNCPOINT

不使用同步点控制放入消息。

MQC.MQPMO_NO_CONTEXT

没有与消息关联的上下文。

MQC.MQPMO_DEFAULT_CONTEXT

将缺省上下文与消息关联。

MQC.MQPMO_SET_IDENTITY_CONTEXT

从应用程序设置标识上下文。

MQC.MQPMO_SET_ALL_CONTEXT

从应用程序设置所有的上下文。

MQC.MQPMO_FAIL_IF_QUIESCING

如果队列管理器停顿，则失败。

MQC.MQPMO_NEW_MSG_ID*

为每个发送消息生成新的消息 id。

MQC.MQPMO_NEW_CORREL_ID*

为每个发送消息生成新的关联 id。

MQC.MQPMO_LOGICAL_ORDER*

将消息组中的逻辑消息和段按它们的逻辑次序放入。

MQC.MQPMO_NONE

没有指定选项。不要与其它选项一起使用。

MQC.MQPMO_PASS_IDENTITY_CONTEXT

从输入队列句柄传送标识上下文。

MQC.MQPMO_PASS_ALL_CONTEXT

从输入队列句柄传送所有的上下文。

MQC.MQPMO_ALTERNATE_USER_AUTHORITY

使用指定的用户标识符验证。

contextReference

public MQQueue ContextReference

这是表明上下文信息源的输入字段。

如果 options 字段包含 MQC.MQPMO_PASS_IDENTITY_CONTEXT 或 MQC.MQPMO_PASS_ALL_CONTEXT， 则设置该字段以指向获取上下文消息的 MQQueue。

该字段的初始值是 null。

recordFields *

public int recordFields

一种标志，指示将消息放置到分配列表时，哪些字段需要 逐个队列地定制。可以指定下列标志中的一个或多个：

MQC.MQPMRF_MSG_ID

使用 MQDistributionListItem 中的 messageId 属性。

MQC.MQPMRF_CORREL_ID

使用 MQDistributionListItem 中的 correlationId 属性。

MQC.MQPMRF_GROUP_ID

使用 MQDistributionListItem 中的 groupId 属性。

MQC.MQPMRF_FEEDBACK

使用 MQDistributionListItem 中的 feedback 属性。

MQC.MQPMRF_ACCOUNTING_TOKEN

使用 MQDistributionListItem 中的 accountingToken 属性。

特殊值 MQC.MQPMRF_NONE 表明没有字段需要定制。

resolvedQueueName.

public String resolvedQueueName

这是由队列管理器设置为放置消息的队列名称的输出字段。如果打开的 队列是别名或模型队列，这将与用于打开队列的名称不同。

resolvedQueueManagerName

public String resolvedQueueManagerName

这是由队列管理器设置为队列管理器名称的输出字段，该队列管理器拥有远程队列名称指定的队列。 这可能与队列管理器(如果队列是远程队列，则可以从该队列管理器访问队列)的名称不同。

knownDestCount *

public int knownDestCount

这是由队列管理器设置为消息数(消息是当前调用已成功发送到解析为本地 队列的队列的消息)的输出字段。 当打开一个不是 分配列表 的一部分的单个队列时，也将设置该字段。

unknownDestCount *

public int unknownDestCount

这是由队列管理器设置为消息数(消息是当前调用已成功发送到解析为远程 队列的队列的消息)的输出字段。 当打开一个 不是分配列表的一部分的 单个队列时，也将设置该字段。

invalidDestCount *

public int invalidDestCount

这是由队列管理器设置为消息数(消息不能被发送到分配列表中的队列)的输出字段。 计数值包含不能成功打开的队列，也包含能成功打开但放入操作失败的队列。 当打开一个 不是分配列表的一部分的单个队列时，也将设置该字段。

构造函数

MQPutMessageOptions

public MQPutMessageOptions()

构造一个没有选项设置的新的 MQPutMessageOptions 对象，以及空白的 resolvedQueueName 和 resolvedQueueManagerName。