目标属性

您可以在“目标”属性对话框中查看和设置目标属性。此对话框中可用的属性取决于目标的类型。

以下各表列出了可以为目标设置的所有属性:

对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。这些表还提供了等价的长名称和短名称以在 JMS 管理命令行工具中使用。“属性”对话框中可用的属性取决于目标的类型;队列目标的某些属性与主题目标的属性不同。有关更多信息,请参阅联机 IBM® MQ 产品文档内的使用管理工具配置 JMS 对象

“常规”页面

下表列出了您可以在“目标属性”对话框的常规页面上设置的属性。

表 1. . 常规页面属性
属性 含义 长名称 短名称
名称 此属性显示对象的名称。 NAME  
描述 输入对象的描述。 DESCRIPTION DESC
类名 此属性显示目标所实现的类名。    
消息传递提供程序 此属性显示目标对象支持的传输,它可以是 IBM MQ 或实时传输。在 IBM MQ V8.0 中无法进行实时传输。如果使用 IBM MQ V8.0,那么可以定义实时传输,但在尝试创建连接时会失败。    
队列管理器 选择或输入主管目标队列的队列管理器的名称。 QMANAGER QMGR
队列 选择目标所表示的队列的名称。 QUEUE QU
主题 输入此目标表示的主题的名称。 TOPIC TOP

“消息处理”页面

下表列出了您可以在“目标属性”对话框的消息处理页面上设置的属性。编辑消息处理页面上的属性以配置对发送至目标的消息执行哪些操作。

表 2. . 消息处理页面属性
属性 含义 长名称 短名称
到期 指定目标处的消息到期前的时间段。要指定可以由 JMS 客户机应用程序来定义到期时间,请单击应用程序。要指定不会到期,请单击无限。否则,请输入消息到期前的毫秒数。 EXPIRY EXP
持久性 指定发送至目标的消息的持久性。 要指定通过 JMS 应用程序来定义持久性,请单击应用程序。要指定持久性采用队列的缺省值,请单击队列缺省值。要指定消息是持久消息,请单击持久。要指定消息是非持久消息,请单击非持久。要指定当队列管理器在停顿或立即关闭后重新启动时不废弃队列中的非持久消息,请单击 (然而,在抢先关闭或故障后,可能会废弃非持久消息)。 PERSISTENCE PER
优先级 指定发送至目标的消息的优先级。 要指定由 JMS 客户机应用程序来定义优先级,请单击应用程序。要指定优先级使用队列缺省值,请单击队列缺省值。否则,请输入优先级,范围为 0 至 9。 PRIORITY PRI
MQMD 消息上下文 指定将消息发送至目标时的上下文。有三个选项可供选择:

缺省值:MQOPEN API 调用和 MQPMO 结构未指定任何显式消息上下文选项。这是缺省值。

设置所有上下文:MQOPEN API 调用指定消息上下文选项 MQOO_SET_ALL_CONTEXT,而 MQPMO 结构则指定 MQPMO_SET_ALL_CONTEXT。

设置标识上下文:MQOPEN API 调用指定消息上下文选项 MQOO_SET_IDENTITY_CONTEXT,而 MQPMO 结构则指定 MQPMO_SET_IDENTITY_CONTEXT。

MDMSGCTX MDCTX
启用 MQMD 写 指定 JMS 应用程序是否可以设置 MQMD 字段的值。有二个选项可供选择:

:将忽略所有 JMS_IBM_MQMD* 属性,并且不会将它们的值复制到底层的 MQMD 结构。这是缺省值。

:将处理所有 JMS_IBM_MQMD* 属性。它们的值将复制到底层的 MQMD 结构。
MDWRITE MDW
启用 MQMD 读 指定 JMS 应用程序是否可以抽取 MQMD 字段的值。有二个选项可供选择:

:发送消息时,将不会更新所发送消息中的 JMS_IBM_MQMD* 属性,从而不会反映 MQMD 中已更新的字段值。接收消息时,在所接收到的消息中不存在任何 JMS_IBM_MQMD* 属性,即使发送方已设置了这些属性的一部分或全部也是如此。 这是缺省值。

:发送消息时,将更新所发送消息中的所有 JMS_IBM_MQMD* 属性(包括发送方未显式设置的那些属性)以反映 MQMD 中已更新的字段值。接收消息时,在所接收到的消息中提供了所有 JMS_IBM_MQMD* 属性(包括发送方未显式设置的那些属性)。
MDREAD MDR
消息体 指定 JMS 应用程序是否将 IBM MQ 消息的 MQRFH2 作为 JMS 消息体的一部分进行处理。有三个选项可供选择:

未指定:发送消息时,IBM MQ JMS 类生成并包含 MQRFH2 头,或者不生成且不包含 MQRFH2 头,具体取决于 WMQ_TARGET_CLIENT 的值。接收消息时,它相当于已将值设置为 JMS。这是缺省值。

JMS:发送消息时,IBM MQ JMS 类自动生成 MQRFH2 头并将其包含在 IBM MQ 消息中。接收消息时,IBM MQ JMS 类按照 MQRFH2(如果存在)中的值设置 JMS 消息属性;它不会提供 MQRFH2 作为 JMS 消息体的一部分。

MQ:发送消息时,IBM MQ JMS 类不会生成 MQRFH2。接收消息时,IBM MQ JMS 类会提供 MQRFH2 作为 JMS 消息体的一部分。

MSGBODY MBODY
接收转换 配置 MQGMO_CONVERT 选项的使用。请求消息时,选择是通过在 MQGET 指定 MQGMO_CONVERT 以在队列管理器中执行转换,还是在客户机应用程序中执行转换。 RECEIVECONVERSION RCNV
接收 CCSID 将消息转换为的请求 CCSID。当 IBM MQ JMS 类请求队列管理器执行转换(例如,通过将 WMQ_RECEIVE_CONVERSION_QMGR 指定为 setReceiveConversion 的参数)时使用。该属性的值是请求队列管理器将消息转换为的 CCSID。缺省值是 CCSID 1208。 RECEIVECCSID RCCS

“代理”页面

下表列出了您可以在“目标属性”对话框的代理页面上设置的属性。编辑代理页面上的属性以提供发布/预订代理的详细信息。

表 3. . 代理页面属性
属性 含义 长名称 短名称
代理持久预订队列 此属性可以在 IBM WebSphere® MQ V7.0 或更高版本的 JMS 客户机中使用,但它对 IBM WebSphere MQ V7.0 或更高版本的队列管理器无效。

如果 JMS 客户机正在连接的队列管理器就是发布预订代理所使用的同一队列管理器,那么您可以从代理队列管理器选择队列。所选队列管理器必须正在运行。

如果不是这种情况,那么您必须输入从中检索持久预订消息的队列的名称。缺省队列是 SYSTEM.JMS.D.SUBSCRIBER.QUEUE。
BROKERDURSUBQ BDSUB
代理 CC 持久预订消息队列 此属性可以在 IBM WebSphere MQ V7.0 或更高版本的 JMS 客户机中使用,但它对 IBM WebSphere MQ V7.0 或更高版本的队列管理器无效。

如果 JMS 客户机正在连接的队列管理器就是发布预订代理所使用的同一队列管理器,那么您可以从代理队列管理器选择队列。所选队列管理器必须正在运行。

如果不是这种情况,那么您必须输入 ConnectionConsumer 从中检索持久预订消息的队列的名称。缺省队列是 SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE。
BROKERCCDURSUBQ CCDSUB
发布流 此属性可以在 IBM WebSphere MQ V7.0 或更高版本的 JMS 客户机中使用,但它对 IBM WebSphere MQ V7.0 或更高版本的队列管理器无效。

选择或输入发布的消息将发送至的队列(流队列)的名称。缺省队列是 SYSTEM.BROKER.DEFAULT.STREAM。要使用“选择”来输入名称,必须已经为代理发布队列管理器属性选择了值,并且所选队列管理器必须正在运行。

BROKERPUBQ BPUB
代理发布队列管理器 选择或输入队列管理器的名称,该队列管理器拥有针对主题发布的消息将发送至的队列。 BROKERPUBQMGR BPQM
代理版本 此属性可以在 IBM WebSphere MQ V7.0 或更高版本的 JMS 客户机中使用,但它对 IBM WebSphere MQ V7.0 或更高版本的队列管理器无效。

选择正在使用的代理的版本。单击 V1 以使用 IBM MQ 发布/预订代理程序或以兼容性方式使用 IBM Integration Bus;如果“传输”属性设置为“绑定”或“客户机”,那么这是缺省值。单击 V2 以本机方式使用 IBM Integration Bus 的代理程序;如果“传输”属性设置为“直接”或“直接 HTTP”,那么这是缺省值。

BROKERVER BVER

“生产者”页面

下表列出了您可以在“目标属性”对话框的生产者页面上设置的属性。编辑生产者页面上的属性以更改目标对象的更多属性。

表 4. . 生产者页面属性
属性 含义 长名称 短名称
允许异步放置 指定是否允许消息生产者使用异步放置来将消息发送至此目标。要通过引用队列或主题定义来确定是否允许使用消息生产者,请单击与目标一样(缺省值)。要允许异步放置,请单击启用;要禁止异步放置,请单击禁用 PUTASYNCALLOWED PAA

“使用者”页面

下表列出了您可以在“目标属性”对话框的使用者页面上设置的属性。编辑使用者页面上的属性以更改目标对象的更多属性。

表 5. . 使用者页面属性
属性 含义 长名称 短名称
允许预读 指定是否允许消息使用者和队列浏览器在接收消息之前使用预读来从此目标中获取非持久消息并放置到客户机缓冲区中。要通过引用队列或主题定义来确定是否允许预读,请单击与目标一样(缺省值)。要允许放置,请单击启用;要禁止放置,请单击禁用 READAHEADALLOWED RAA®
预读关闭策略 对于正在传递至异步消息侦听器的消息,请指定当关闭消息使用者时应该对客户机代理队列中的消息执行的操作。要指定客户机代理队列中的所有消息都将在 应用程序的 MessageListener 返回之前传递至该 MessageListener,请单击全部传递(缺省值)。要指定在返回之前仅完成当前 MessageListener 调用(有可能会废弃客户机代理队列中的其他消息),请单击传递当前内容 READAHEADCLOSEPOLICY RACP
通配符格式 指定要使用通配符语法的哪个版本。

单击仅使用字符通配符以仅使用字符通配符(以便与先前使用的代理版本 1 的应用程序一致;请参阅“代理版本”属性)。

单击仅使用主题通配符以仅使用主题级别的通配符,代理版本 2 中使用这些通配符。
WILDCARDFORMAT WCFMT

“扩展”页面

下表列出了您可以在“目标属性”对话框的扩展页面上设置的属性。编辑扩展页面上的属性以更改目标对象的更多属性。

表 6. . 扩展页面属性
属性 含义 长名称 短名称
编码字符集标识 输入要用于目标的编码字符集(CCSID)。 CCSID CCS
编码 选择用于此目标的编码方案。有关更多信息,请参阅 IBM MQ 联机产品文档中的使用管理工具配置 JMS 对象 ENCODING ENC
停顿时终止 指定对某些方法的调用在队列管理器处于停顿状态时终止。要指定对某些方法的调用在队列管理器处于停顿状态时终止,请单击。这意味着:如果应用程序检测到队列管理器处于停顿状态,那么应用程序可以完成其即时任务并关闭连接,以允许队列管理器停止。要指定任何方法调用都不会因为队列管理器处于停顿状态而终止,请单击。这意味着应用程序无法检测到队列管理器处于停顿状态这一情况,所以应用程序可能继续对队列管理器执行操作,因此会妨碍队列管理器停止。 FAILIFQUIESCE FIQ
多点广播 指定是否将消息传递至使用多点广播传输的消息使用者。多点广播传输仅适用于主题目标,并且仅当连接工厂使用“直接 IP”传输时才能使用。在 IBM MQ V8.0 中无法进行直接 IP 传输。如果使用 IBM MQ V8.0,那么可以定义直接 IP 传输,但在尝试创建连接时会失败。

缺省值是作为连接工厂,它表示将使用连接工厂的多点广播属性的值。

单击启用以将消息传递至使用多点广播传输的消息使用者。 必须配置主题才能在代理中进行可靠的多点广播;如果已配置主题进行可靠的多点广播,那么将使用可靠的服务质量。

单击可靠以将消息传递至使用服务质量可靠的多点广播传输的消息使用者。必须配置主题才能在代理中进行可靠的多点广播;如果未配置主题进行可靠的多点广播,那么不能为主题创建消息使用者。

单击不可靠以将消息传递至使用多点广播传输,但未使用可靠的服务质量的消息使用者。必须配置主题才能在代理中进行多点广播;即使已配置主题进行可靠的多点广播,也不会使用可靠的服务质量。
MULTICAST MCAST
目标客户机

单击 JMS 以指定消息的目标是 JMS 应用程序。

单击 MQ 以指定消息的目标是非 JMS IBM MQ 应用程序。

TARGCLIENT TC
ReplyTo 目标样式

指定 JMSReplyTo 字段的格式。

单击缺省值以使用缺省值。除非已设置 JVM 系统属性,否则缺省值等同于 RFH2 中的信息。

单击 MQMD 以使用 MQMD 中提供的值。此操作将使用来自 MQMD 的值来填充队列管理器字段。

单击 RFH2 以使用 RFH2 头中提供的值。如果发送应用程序设置 JMSReplyTo 值,那么该值将被使用。

REPLYTOSTYLE RTOST
接收转换 配置 MQGMO_CONVERT 选项的使用。 请求消息时,选择是通过在 MQGET 指定 MQGMO_CONVERT 以在队列管理器中执行转换,还是在客户机应用程序中执行转换。 RECEIVECONVERSION RCNV
接收 CCSID 消息要转换为的请求 CCSID。 当 IBM MQ JMS 类请求队列管理器执行转换(例如,通过将 WMQ_RECEIVE_CONVERSION_QMGR 指定为 setReceiveConversion 的参数)时使用。该属性的值是请求队列管理器将消息转换为的 CCSID。缺省值是 CCSID 1208。 RECEIVECCSID RCCS

参考 参考

反馈

时间戳记图标 最近一次更新时间: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/j_properties_destination.htm