目标属性
您可以在“目标”属性对话框中查看和设置目标属性。 此对话框中可用的属性取决于目标的类型。
以下各表列出了可以为目标设置的所有属性:
对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。 这些表还提供了等价的长名称和短名称以在 JMS 管理命令行工具中使用。 “属性”对话框中可用的属性取决于目标的类型;队列目标的某些属性与主题目标的属性不同。 有关更多信息,请参阅 IBM® 文档中的 使用管理工具配置 JMS 对象 。
“常规”页面
下表列出了您可以在“目标属性”对话框的常规页面上设置的属性。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
名称 | 此属性显示对象的名称。 | 名称 | |
描述 | 输入对象的描述。 | 描述 | DESC |
类名 | 此属性显示目标所实现的类名。 | ||
消息传递提供程序 | 这将显示目标对象支持的传输,可以是 IBM MQ 或实时传输。 实时传输在 IBM MQ 8.0中不可用。 如果您正在使用 IBM MQ 8.0 ,那么可以定义实时传输,但在尝试创建连接时失败。 | ||
队列管理器 | 选择或输入主管目标队列的队列管理器的名称。 | QMANAGER | QMGR |
队列 | 选择目标所表示的队列的名称。 | 队列 | QU |
Topic | 输入此目标表示的主题的名称。 | TOPIC | TOP |
“消息处理”页面
下表列出了您可以在“目标属性”对话框的消息处理页面上设置的属性。 编辑消息处理页面上的属性以配置对发送至目标的消息执行哪些操作。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
到期 | 指定目标处的消息到期前的时间段。 要指定可以由 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 应用程序是否在 JMS 消息体中处理 IBM MQ 消息的 MQRFH2 。 有三个选项可供选择: 未指定: 发送消息时; IBM MQ classes for JMS 是否生成并包含 MQRFH2 头,取决于 WMQ_TARGET_CLIENT 的值。 接收消息时,它相当于已将值设置为 JMS。 这是缺省值。 JMS: 发送消息时; IBM MQ JMS 类会自动生成 MQRFH2 头,并将其包含在 IBM MQ 中 消息。 接收消息时, IBM MQ classes for 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 |
“代理”页面
下表列出了您可以在“目标属性”对话框的代理页面上设置的属性。 编辑代理页面上的属性以提供发布/预订代理的详细信息。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
代理程序持久预订队列 | 此属性可以在 IBM WebSphere® MQ 7.0或更高版本的 JMS 客户机中使用,但对 IBM WebSphere MQ 7.0或更高版本的队列管理器没有任何影响。 如果 JMS 客户机正在连接的队列管理器就是发布预订代理所使用的同一队列管理器,那么您可以从代理队列管理器选择队列。 所选队列管理器必须正在运行。 如果不是这种情况,那么您必须输入从中检索持久预订消息的队列的名称。 缺省队列是 SYSTEM.JMS.D.SUBSCRIBER.QUEUE。 |
BROKERDURSUBQ | BDSUB |
代理程序 CC 持久预订消息队列 | 此属性可以在 IBM WebSphere MQ 7.0或更高版本的 JMS 客户机中使用,但对 IBM WebSphere MQ 7.0或更高版本的队列管理器没有任何影响 如果 JMS 客户机正在连接的队列管理器就是发布预订代理所使用的同一队列管理器,那么您可以从代理队列管理器选择队列。 所选队列管理器必须正在运行。 如果不是这种情况,那么您必须输入 ConnectionConsumer 从中检索持久预订消息的队列的名称。 缺省队列是 SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE。 |
BROKERCCDURSUBQ | CCDSUB |
发布流 | 此属性可以在 IBM WebSphere MQ 7.0或更高版本的 JMS 客户机中使用,但对 IBM WebSphere MQ 7.0或更高版本的队列管理器没有影响。 选择或输入发布的消息将发送至的队列(流队列)的名称。 缺省队列是
SYSTEM.BROKER.DEFAULT.STREAM。 要使用“选择”来输入名称,必须已经为 |
BROKERPUBQ | BPUB |
代理程序发布队列管理器 | 选择或输入队列管理器的名称,该队列管理器拥有针对主题发布的消息将发送至的队列。 | BROKERPUBQMGR | BPQM |
代理程序版本 | 此属性可以在 IBM WebSphere MQ 7.0或更高版本的 JMS 客户机中使用,但对 IBM WebSphere MQ 7.0或更高版本的队列管理器没有影响。 选择正在使用的代理的版本。 单击 |
BROKERVER | BVER |
“生产者”页面
下表列出了您可以在“目标属性”对话框的生产者页面上设置的属性。 编辑生产者页面上的属性以更改目标对象的更多属性。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
允许异步放置 | 指定是否允许消息生产者使用异步放置来将消息发送至此目标。 要通过引用队列或主题定义来确定是否允许使用消息生产者,请单击与目标一样(缺省值)。 要允许异步放置,请单击启用;要禁止异步放置,请单击禁用。 | PUTASYNCALLOWED | PAA |
“使用者”页面
下表列出了您可以在“目标属性”对话框的使用者页面上设置的属性。 编辑使用者页面上的属性以更改目标对象的更多属性。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
允许预先读取 | 指定是否允许消息使用者和队列浏览器在接收消息之前使用预读来从此目标中获取非持久消息并放置到客户机缓冲区中。 要通过引用队列或主题定义来确定是否允许预读,请单击与目标一样(缺省值)。 要允许放置,请单击启用;要禁止放置,请单击禁用。 | READAHEADALLOWED | RAA ® |
预先读取关闭策略 | 对于正在传递至异步消息侦听器的消息,请指定当关闭消息使用者时应该对客户机代理队列中的消息执行的操作。 要指定客户机代理队列中的所有消息都将在 应用程序的 MessageListener 返回之前传递至该 MessageListener,请单击全部传递(缺省值)。 要指定在返回之前仅完成当前 MessageListener 调用(有可能会废弃客户机代理队列中的其他消息),请单击传递当前内容。 | READAHEADCLOSEPOLICY | RACP |
通配符格式 | 指定要使用通配符语法的哪个版本。 单击仅使用字符通配符以仅使用字符通配符(以便与先前使用的代理版本 1 的应用程序一致;请参阅“代理版本”属性)。 单击仅使用主题通配符以仅使用主题级别的通配符,代理版本 2 中使用这些通配符。 |
WILDCARDFORMAT | WCFMT |
“扩展”页面
下表列出了您可以在“目标属性”对话框的扩展页面上设置的属性。 编辑扩展页面上的属性以更改目标对象的更多属性。
属性 | 含义 | 长名称 | 短名称 |
---|---|---|---|
编码字符集标识 | 输入要用于目标的编码字符集(CCSID)。 | CCSID | CCS |
编码 | 选择用于此目标的编码方案。 有关更多信息,请参阅 IBM 文档中的 使用管理工具配置 JMS 对象 。 | 编码 | ENC |
停顿时终止 | 指定对某些方法的调用在队列管理器处于停顿状态时终止。 要指定对某些方法的调用在队列管理器处于停顿状态时终止,请单击是。 这意味着:如果应用程序检测到队列管理器处于停顿状态,那么应用程序可以完成其即时任务并关闭连接,以允许队列管理器停止。 要指定任何方法调用都不会因为队列管理器处于停顿状态而失败,请单击否。 这意味着应用程序无法检测到队列管理器处于停顿状态,因此应用程序可能会继续对队列管理器执行操作,因此,阻止队列管理器停止。 | FAILIFQUIESCE | FIQ |
多点广播 | 指定是否将消息传递至使用多点广播传输的消息使用者。 多点广播传输仅适用于主题目标,并且仅当连接工厂使用“直接 IP”传输时才能使用。 直接 IP 传输在 IBM MQ 8.0中不可用。 如果您正在使用 IBM MQ 8.0 ,那么可以定义直接 IP 传输,但在尝试创建连接时失败。 缺省值是作为连接工厂,它表示将使用连接工厂的多点广播属性的值。 单击启用以将消息传递至使用多点广播传输的消息使用者。 必须配置主题才能在代理中进行可靠的多点广播;如果已配置主题进行可靠的多点广播,那么将使用可靠的服务质量。 |
MULTICAST | MCAST |
多点广播(续) | 单击可靠以将消息传递至使用服务质量可靠的多点广播传输的消息使用者。 必须配置主题才能在代理中进行可靠的多点广播;如果未配置主题进行可靠的多点广播,那么不能为主题创建消息使用者。 单击不可靠以将消息传递至使用多点广播传输,但未使用可靠的服务质量的消息使用者。 必须配置主题才能在代理中进行多点广播;即使已配置主题进行可靠的多点广播,也不会使用可靠的服务质量。 |
MULTICAST | MCAST |
目标客户机 | 单击 JMS 以指定消息的目标是 JMS 应用程序。 单击 MQ 以指定消息的目标是非 JMS IBM MQ 应用程序。 |
TARGCLIENT | TC |
应答目标样式 | 指定 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 |