应用程序客户机的 IBM MQ 提供程序队列连接工厂设置

使用此面板查看或更改所选队列连接工厂的配置属性,以供 IBM MQ Java™ 消息服务 (JMS) 提供程序使用。这些配置属性控制如何创建 JMS 提供程序和 IBM MQ 之间的连接。

要查看此 Application Client Resource Configuration Tool (ACRCT) 页面,单击文件 > 打开。在您浏览 EAR 文件后,单击打开。展开所选 JAR 文件并单击消息传递提供程序 > IBM MQ 提供程序。右键单击队列连接工厂,并单击新建。以下字段出现在常规选项卡上。

注:
  • 指定的属性值必须与您配置 JMS 资源的 IBM MQ 时指定的值匹配。有关为 JMS 资源配置 IBM MQ 的更多信息,请参阅 IBM MQ 信息中心的“使用 Java”部分。
  • 在 IBM MQ 中,名称最大长度为 48 个字符,但通道名例外,通道名的最大长度为 20 个字符。

JMS 提供程序的队列连接工厂具有以下属性。

名称

在 WebSphere® Application Server 中,为了进行管理而提供的用于识别此队列连接工厂的名称。此名称在跨 WebSphere 管理域的 JMS 连接工厂中是唯一的。

信息 值
数据类型 字符串

描述

在 WebSphere Application Server 中,为了进行管理而提供的对此连接工厂的描述。

信息 值
数据类型 字符串
缺省值 Null

JNDI 名称

应用程序客户机运行时使用此字段检索配置信息。

用户标识

如果调用应用程序未显式提供用户标识和密码,那么将带有密码属性的用户标识用于认证。

如果您指定用户标识属性的值,那么您还必须指定密码属性的值。

如果调用应用程序未显式提供用户标识和密码,那么使用连接工厂用户标识和密码属性;例如,如果调用应用程序使用方法 createQueueConnection()。JMS 客户机将用户标识和密码传递到 JMS 服务器。

信息 值
数据类型 字符串

密码

如果调用应用程序未显式提供用户标识和密码,那么将带有用户标识属性的密码用于认证。

如果您指定用户标识属性的值,那么您还必须指定密码属性的值。

信息 值
数据类型 字符串
缺省值 Null

重新输入密码

确认密码。

队列管理器

此连接工厂的 IBM MQ 队列管理器的名称。

此工厂创建的连接与该队列管理器连接。

信息 值
数据类型 字符串

输入主机名和端口信息

缺省情况下会选中此单选按钮,如果选中了此单选按钮,那么它会启用主机名和端口属性并禁用连接名称列表属性。

信息 值
数据类型 单选按钮
缺省值 已选中

主机

仅对于客户机连接,运行 IBM MQ 队列管理器的主机的名称。

信息 值
数据类型 字符串
缺省值 Null
范围 有效的 TCP/IP 主机名

端口

用于连接至 IBM MQ 队列管理器的 TCP/IP 端口号(仅用于客户机连接)。

必须在 IBM MQ 队列管理器上配置此端口。

信息 值
数据类型 整数
缺省值 Null
范围 在 IBM MQ 队列管理器上配置的有效 TCP/IP 端口号。

输入连接名称列表信息

如果选中,那么此单选按钮会启用连接名称列表属性并禁用主机和端口名称属性。如果要连接至多实例队列管理器,请选中此单选按钮。

信息 值
数据类型 单选按钮
缺省值 未选中

连接名称列表

可用于连接至多实例队列管理器的主机和端口信息的逗号分隔列表。

此列表的格式为:
host[(port)],[host[(port)]]
其中 port 是可选的,如果未设置,那么缺省值是 1414。例如:
hostname1,hostname2(1415)

有关多实例队列管理器的进一步信息,请参阅 IBM MQ 信息中心。

此属性只能用于连接至多实例队列管理器。它不能用于连接至一列不同队列管理器,因为这样做可能导致事务完整性问题。

通道

用于连接至 IBM MQ 队列管理器的通道名(仅用于客户机连接)。

信息 值
数据类型 字符串
缺省值 Null
范围 1 到 20 个 ASCII 字符

传输类型

指定是使用 IBM MQ 客户机连接还是使用 JNDI 绑定来连接到 IBM MQ 队列管理器。外部 JMS 提供程序控制 JMS 客户机和 JMS 服务器之间的通信协议。当您使用非 ASF 非持久性、非持续性、非事务性消息传递时,或者当您要满足安全性问题,而客户机对于队列管理器节点是本地时,调整传输类型。

信息 值
数据类型 枚举
单位 不适用
缺省值 BINDINGS
范围
BINDINGS
JNDI 绑定用于连接到队列管理器。BINDINGS 是共享的内存协议,并且仅可以在队列管理器和JMS 客户机在同一节点上时才能使用它,而且它存在安全性风险(必须通过使用 EJB 角色来处理此风险)。
CLIENT
IBM MQ 客户机连接用于连接到队列管理器。CLIENT 是典型的基于 TCP 的协议。
DIRECT
用于使用 DIRECT 方式的 IBM MQ Event Broker。DIRECT 是轻量级套接字协议,在非事务、非持久和非持久发布/预订消息传递中使用它。DIRECT 仅作用于使用非 ASF 协议的客户机和消息驱动的 Bean。
QUEUED
QUEUED 是标准 TCP 协议。
建议
队列连接工厂传输类型
BINDINGS 可加快 30% 或更多,但它需要正确地设置 EJB 角色才能保证安全。如果存在安全性问题并且需要使用 CLIENT,那么您应该正确利用 SSL 来保护与队列管理器的连接。
主题连接工厂传输类型
DIRECT 是最快速的类型,并且必须尽可能的使用它。当您要满足其他安全任务,而且队列管理器对于 JMS 客户机是本地时,使用 BINDINGS。QUEUED 是所有其他情况的退守方法。具有 DIRECT 设置的 CSD2 之前的 IBM MQ 5.3 与消息驱动的 Bean 协同使用并处于负载状态时,会丢失消息。客户端应用程序也会发生该丢失 (除非代理 maxClientQueueSize 设置为 0)。您可以使用命令将此值设置为 0:
#wempschangeproperties WAS_nodeName_server1
 -e default -o DynamicSubscriptionEngine -n
 maxClientQueueSize -v 0 -x executionGroupUUID
其中 executionGroupUUID 可以通过启动代理和在事件日志/应用程序中查找事件 2201 来找到。此值通常是 ffffffff-0000-0000-000000000000。
注: 由于 WebSphere Application Server V6.1 含有 Java 5 运行时,所以不能在 WebSphere Application Server V6.1 中使用 IBM MQ 5.3 JMS。因此,不能使用 IBM MQ 5.3 队列管理器来建立跨内存连接。如果您先前使用 IBM MQ 5.3 和 BINDINGS 来进行连接,并且在迁移至 WebSphere Application Server V6.1 时改为使用 CLIENT 网络连接,那么可能会导致性能下降。

客户机标识

用于连接到 IBM MQ 队列管理器的 JMS 客户机标识。

信息 值
数据类型 字符串

CCSID

用于与 IBM MQ 队列管理器配合使用的编码字符集标识。

此编码字符集标识 (CCSID) 必须是 IBM MQ 支持的其中一个 CCSID。

信息 值
数据类型 字符串

有关受支持 CCSID 以及将消息数据从一个编码字符集转换为另一个编码字符集的更多信息,请参阅 IBM MQ 信息中心的“系统管理”部分和“应用程序编程参考”部分。

消息保留

选中此复选框以指定将不需要的消息留在队列中。否则,将根据那些不需要的消息的处置选项来处理它们。

信息 值
数据类型 枚举
单位 不适用
缺省值 未选中
范围
已选中
在队列上保留多余消息。
未选中
根据多余消息的处置选项处理它们。

临时模型

当连接工厂还未存在时,用于创建临时连接工厂的模型定义的名称。

信息 值
数据类型 字符串
范围 1 到 48 个 ASCII 字符

临时队列前缀

用于进行动态队列命名的前缀。

信息 值
数据类型 字符串

如果停顿,那么失败

如果队列管理器已发生控制故障,那么指定应用程序是否从方法调用返回。

信息 值
数据类型 复选框
缺省值 已选中

本地服务器地址

指定本地服务器地址。

信息 值
数据类型 字符串

轮询时间间隔

指定异步消息传递期间扫描所有接收方之间的时间间隔(以毫秒计)

信息 值
数据类型 整数
单位 毫秒
缺省值 5000

重新扫描时间间隔

指定扫描主题以查找无序地添加至主题的消息之间的时间间隔(以毫秒计)。

此时间间隔控制扫描已添加至主题的无序的消息,它与 IBM MQ 浏览光标相关。

信息 值
数据类型 整数
单位 毫秒
缺省值 5000

SSL 密码套件

指定用于以 SSL 方式连接到 IBM MQ 的密码套件。

将此属性设置为您的 JSSE 提供程序提供的有效密码套件。该值必须与在 SVRCONN 通道上作为通道属性指定的 CipherSpec 匹配。

如果您设置 SSL 对等名称属性,则必须设置此属性。

SSL 证书库

指定零或多个证书撤销列表(CRL)的列表,以检查 SSL 证书撤销。如果您为此属性指定值,那么必须使用 Java 2 V1.4 上的 IBM MQ JVM。

此值是一个表单条目(这些条目用空格隔开)列表:
ldap://hostname:[port]

单个斜杠 (/) 在该值之后。如果省略 port,那么假设缺省 LDAP 端口为 389。连接时,对照指定的 CRL 服务器检查服务器提供的 SSL 证书。有关 CRL 安全性的更多信息,请参阅 IBM MQ 信息中心的“安全性”部分中有关“使用证书撤销列表”的信息。

SSL 对等名称

对于 SSL,专有名称框架必须与 IBM MQ 队列管理器提供的名称匹配。专有名称用于检查连接时服务器提供的标识证书。

如果未设置此属性,那么执行该证书检查。

如果未指定 SSL 密码套件属性,那么忽略 SSL 对等名称属性。

此属性是由逗号或分号分隔的属性名和值对列表。例如:
CN=QMGR.*, OU=IBM, OU=WEBSPHERE

给出的示例在连接时检查服务器提供的标识证书。要使连接成功,证书必须具有以 QMGR. 开头的公共名,并且必须至少有两个组织单元(OU)名称,第一个名称为 IBM®,第二个名称为 WEBSPHERE。检查不区分大小写。

有关专有名称及其与 IBM MQ 的配合使用的更多详细信息,请参阅 IBM MQ 信息中心中有关“专有名称”的信息。

连接池

指定连接池设置的可选集合。

连接池属性对于所有 J2C 连接器是公共的。

应用程序服务器将连接和会话与 JMS 提供程序共享,以改进性能。此连接池独立于任何 IBM MQ 连接池。必须为应用程序正确地配置连接和会话池属性,否则也许不能获取需要的连接和会话行为。

如果对 JMS 资源的并发服务器端访问超出缺省值,那么更改连接池的大小。在每个队列或主题基础上设置连接池的大小。

信息 值
数据类型 复选框
缺省值 已选中

客户机重新连接选项

指定通信或队列管理器失败时客户机方式连接是否自动重新连接。除非正在瘦客户机环境或受管客户机环境中使用连接工厂,否则会忽略此属性。

信息 值
数据类型 下拉列表
缺省值 已禁用
范围
已禁用
客户机重新连接不自动进行。
ASDEF
将使用客户机配置文件的通道节的 DefRecon 属性中的值。如果未指定 DefRecon 值,那么此设置与 DISABLED 值有相同效果。
RECONNECT
与队列管理器属性值保持一致的任何队列管理器会进行重新连接,此队列管理器可能不同于此连接最初连接至的队列管理器。
QMGR
仅此连接最初连接至的队列管理器才进行重新连接。

有关自动客户机重新连接的更多信息,请参阅 IBM MQ 信息中心。

客户机重新连接超时

通信或队列管理器失败后客户机方式连接尝试自动重新连接至队列管理器时所耗的最长时间(以秒计)。除非正在瘦客户机环境或受管客户机环境中使用连接工厂,否则会忽略此参数。是否使用此参数取决于客户机重新连接选项参数的值。

信息 值
数据类型 整数
单位 秒
缺省值 1800
范围 大于零并且最高为 2147483647 的值

有关自动客户机重新连接的更多信息,请参阅 IBM MQ 信息中心。


指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=ucli_pqcfm
文件名:ucli_pqcfm.html