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

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

要查看该 Application Client Resource Configuration Tool (ACRCT) 页面,单击文件 > 打开。在您浏览 EAR 文件后,单击打开。展开所选 JAR 文件 > 消息传递提供程序 > WebSphere MQ 提供程序。右键单击主题连接工厂,并单击新建

注意:
MA0C 代理程序:在为 MA0C 代理程序创建 WebSphere Application Server V6 主题连接工厂时,应该考虑下列属性值:
BrokerControlQueue
对于 MA0C 代理程序来说,此值固定为 SYSTEM.BROKER.CONTROL.QUEUE,这是该代理程序要读取的队列。
BrokerVersion
对于 MA0C 代理程序来说,将此值设置为 BASIC。
ClientID
对于 MA0C 代理程序来说,可以任意设置此值(此值是一个字符串,它仅仅是客户机应用程序的标识)。
启用 XA
对于 MA0C 代理程序来说,将此值设置为 TRUE 或 FALSE(使用的设置是性能提高标志 - 在大部分情况下,您可能想将此值设置为“true”)。
BrokerMessage Selection
对于 MA0C 代理程序来说,由于它依赖于客户端消息选择,所以此值固定为 CLIENT。
直接代理程序授权类型
MA0C 代理程序不需要此值。

WebSphere MQ 产品 JMS 提供程序的主题连接工厂具有下列属性。

名称

在 WebSphere Application Server 中,为了进行管理而提供的用于识别此主题连接工厂的名称。此名称在 JMS 提供程序中必须唯一。

数据类型 字符串
描述

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

数据类型 字符串
JNDI 名称

用于将主题连接工厂绑定到应用程序服务器名称空间的 Java 命名和目录接口(JNDI)名称。

按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。

该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 45 个 ASCII 字符
用户标识

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

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

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

数据类型 字符串
密码

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

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

数据类型 字符串
重新输入密码

确认密码。

队列管理器

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

数据类型 字符串
输入主机名和端口信息

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

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

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

数据类型 字符串
范围 有效的 TCP/IP 主机名
端口

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

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

数据类型 整型
范围 有效的 TCP/IP 端口号,在 WebSphere MQ 队列管理器上配置。
输入连接名称列表信息

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

数据类型 单选按钮
缺省值 未选中
连接名称列表

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

此列表的格式为:

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

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

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

通道

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

数据类型 字符串
范围 1 到 20 个 ASCII 字符
传输类型

为连接到 WebSphere MQ 队列管理器使用 WebSphere MQ 客户机连接还是使用 JNDI 绑定。

数据类型 枚举
缺省值 BINDINGS
范围
CLIENT
使用 WebSphere MQ 客户机连接连接到 WebSphere MQ 队列管理器。
BINDINGS
使用 JNDI 绑定连接到 WebSphere MQ 队列管理器。
客户机标识

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

数据类型 字符串
CCSID

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

此编码字符集标识 (CCSID) 必须是 WebSphere MQ 所支持的某个 CCSID。有关更多详细信息,请参阅主题连接工厂的属性。

数据类型 字符串
单元 整型
范围 1 到 65535
代理程序控制队列

代理控制队列的名称,所有命令消息(发布消息以及删除发布消息的请求除外)都将发送到此队列。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 48 个 ASCII 字符
代理程序队列管理器

提供发布者和订户消息代理的 WebSphere MQ 队列管理器的名称。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 48 个 ASCII 字符
代理程序发布队列

用于接收缺省流的所有发布消息的代理输入队列的名称。

接收缺省流的所有发布消息的代理输入队列(流队列)的名称。应用程序还可将缺省流上要删除发布的请求发送到此队列。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 48 个 ASCII 字符
代理程序预订队列

检索非持续预订消息的代理队列的名称。

检索非持续预订消息的代理队列的名称。订户在注册预订时指定队列名。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 48 个 ASCII 字符
代理程序 CCSubQ

为 ConnectionConsmer 请求检索非持续预订消息的代理队列的名称。此属性仅适用于 Web 容器使用。

数据类型 字符串
单元 美国英语 ASCII 字符
范围 1 到 48 个 ASCII 字符
代理程序版本

消息代理是由 WebSphere MQ MA0C SupportPac™ 提供还是由更高版本的 WebSphere 系列消息代理产品提供。

数据类型 枚举
缺省值 高级
范围
高级
消息代理由更新版本的 WebSphere 系列消息代理产品(MQ Integrator 和 MQ Publish and Subscribe)提供。
基本
消息代理由 WebSphere MQ MA0C SupportPac(WebSphere MQ - Publish and Subscribe)提供。
清除级别

发布或预订清除实用程序提供的清除的级别。

数据类型 枚举
缺省值 SAFE
范围
ASPROP
NONE
STRONG
清除时间间隔

后台执行发布/预订清除实用程序之间的时间间隔(以毫秒计)。

数据类型 整型
单元 毫秒
缺省值 6000
消息选择

指定代理消息选择的执行位置。

数据类型 枚举
缺省值 BROKER
范围
BROKER
在代理位置执行消息选择。
Message CLIENT
在客户机位置执行消息选择。
发布确认时间间隔

要求代理确认的发布请求之间的时间间隔(以消息数计)。

数据类型 整型
缺省值 25
稀疏预订

启用稀有预订。

数据类型 复选框
缺省值 未选中
状态刷新时间间隔

刷新发布或预订状态的事务之间的时间间隔(以毫秒计)。

数据类型 整型
缺省值 6000
预订存储

WebSphere MQ 存储与活动 JMS 预订相关的数据的位置。

数据类型 枚举
缺省值 MIGRATE
范围
MIGRATE
QUEUE
BROKER
多点广播

此连接工厂是否使用多点广播传输。

数据类型 枚举
缺省值 NOT USED
范围
NOT USED
此连接工厂不使用多点广播传输。
ENABLED
此连接工厂总是使用多点广播传输。
ENABLED_IF_AVAILABLE
此连接工厂使用多点广播传输。
ENABLED_RELIABLE
此连接工厂使用可靠的多点广播传输。
ENABLED_RELIABLE_IF_AVAILABLE
此连接工厂使用可靠多点广播传输(如果可用)。
直接认证

是否使用直接代理授权。

数据类型 枚举
缺省值
范围
NONE
不使用直接代理授权。
PASSWORD
用密码认证直接代理授权。
CERTIFICATE
用证书认证直接代理授权。
代理主机名

用于与 WebSphere MQ 通信的代理的主机名。

数据类型 字符串
代理端口

用于与 WebSphere MQ 通信的代理的端口号。

数据类型 整型
缺省值 0
停顿时使失败

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

数据类型 复选框
缺省值 所选项
本地服务器地址

本地服务器地址。

数据类型 字符串
轮询时间间隔

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

数据类型 整型
单元 毫秒
缺省值 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 信息中心。




标有(在线)的链接需要访问因特网。



文件名:ucli_ptcfm.html