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

名称

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

数据类型

字符串

描述

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

数据类型	字符串
缺省值	Null

JNDI 名称

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

用户标识

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

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

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

数据类型

字符串

密码

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

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

数据类型	字符串
缺省值	Null

重新输入密码

确认密码。

队列管理器

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

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

数据类型

字符串

输入主机名和端口信息

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

数据类型	单选按钮
缺省值	所选项

主机

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

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

端口

用于连接到 WebSphere MQ 队列管理器的 TCP/IP 端口号（仅用于客户机连接）。

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

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

输入连接名称列表信息

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

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

连接名称列表

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

此列表的格式为：

host[(port)],[host[(port)]]

其中 port 是可选的，如果未设置，那么缺省值为 1414。例如：

hostname1,hostname2(1415)

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

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

通道

用于连接到 WebSphere MQ 队列管理器的通道名（仅用于客户机连接）。

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

传输类型

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

数据类型	枚举
单元	不适用
缺省值	BINDINGS
范围	BINDINGS JNDI 绑定用于连接到队列管理器。BINDINGS 是共享的内存协议，并且仅可以在队列管理器和JMS 客户机在同一节点上时才能使用它，而且它存在安全性风险（应该通过使用 EJB 角色来处理此风险）。 CLIENT WebSphere MQ 客户机连接用于连接到队列管理器。CLIENT 是典型的基于 TCP 的协议。 DIRECT 用于使用 DIRECT 方式的 WebSphere MQ Event Broker。DIRECT 是轻量级套接字协议，在非事务、非持久和非持久发布/预订消息传递中使用它。DIRECT 仅作用于使用非 ASF 协议的客户机和消息驱动的 bean。 QUEUED QUEUED 是标准 TCP 协议。
建议	队列连接工厂传输类型 BINDINGS 可加快 30% 或更多，但是它缺乏安全性。当您在安全性方面已采取相应措施时，BINDINGS 比 CLIENT 更合适。 主题连接工厂传输类型 DIRECT 是最快速的类型，并应该尽可能的使用它。当您要满足其他安全任务，而且队列管理器对于 JMS 客户机是本地时，使用 BINDINGS。QUEUED 是所有其他情况的退守方法。具有 DIRECT 设置的 CSD2 之前的 WebSphere 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。 注意：由于 WAS 6.1 带有 Java 5 运行时，所以不能在 WAS 6.1 中使用 WebSphere MQ 5.3 JMS。因此，不能使用 WebSphere MQ 5.3 队列管理器来建立跨内存连接。如果您先前使用 WebSphere MQ 5.3 和 BINDINGS 来进行连接，并且在迁移至 WebSphere Application Server V6.1 时改为使用 CLIENT 网络连接，那么可能会导致性能下降。如果您正在使用 WebSphere MQ 5.3 for z/OS®，那么可能还必须购买另一个功能部件包。 由于当前未提供 64 位 WebSphere MQ z/OS，并且不能使用 BINDINGS 方式来连接到 31 位 WebSphere MQ z/OS，所以，在 64 位 z/OS 上运行时，必须将传输类型设置为 CLIENT。您还可能需要购买另一个 WebSphere MQ 功能部件包才能获得此支持。

客户机标识

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

数据类型

字符串

CCSID

由 WebSphere MQ 队列管理器使用的编码字符集标识。

此编码字符集标识（CCSID）必须是 WebSphere MQ 所支持的某个 CCSID。

数据类型

字符串

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

消息保留

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

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

临时模型

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

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

临时队列前缀

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

数据类型

字符串

停顿时使失败

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

数据类型	复选框
缺省值	所选项

本地服务器地址

指定本地服务器地址。

数据类型

字符串

轮询时间间隔

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

数据类型	整型
单元	毫秒
缺省值	5000

重新扫描时间间隔

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

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

数据类型	整型
单元	毫秒
缺省值	5000

SSL 密码套件

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

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

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

SSL 证书库

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

此值是一个表单条目（这些条目用空格隔开）列表：

ldap://hostname:[port]

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

SSL 对等名称

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

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

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

此属性是由逗号或分号分隔的属性名和值对列表。例如：

CN=QMGR.*, OU=IBM, OU=WEBSPHERE

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

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

连接池

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

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

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

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

数据类型	复选框
缺省值	所选项

客户机重新连接选项

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

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

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

客户机重新连接超时

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

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

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