WebSphere MQ 消息传递提供程序连接工厂设置

使用此面板查看或更改所选连接工厂的配置属性,以和 WebSphere® MQ 消息传递提供程序配合使用。这些配置属性控制如何创建到关联的 JMS 队列和主题的连接。

WebSphere MQ 消息传递提供程序支持独立于域的 JMS 1.1 接口,如统一 JMS 连接工厂。独立于域的应用程序可以将相同接口用于点到点消息传递和发布/预订消息传递,并可以支持在同一事务中进行点到点消息传递和发布/预订消息传递。有了 JMS 1.1,建议您对新的应用程序使用独立于域的统一 JMS 连接工厂。特定于域的接口扩展独立于域的等价接口,所以使用特定于域的队列和主题连接工厂的应用程序可以选择使用任一接口。

要查看 WebSphere MQ 连接工厂设置,请使用管理控制台来完成下列步骤:
  1. 在导航窗格中,单击资源 > JMS > 连接工厂以显示现有连接工厂。
  2. 如果合适的话,在内容窗格中,将作用域设置更改为定义连接工厂所在的级别。这将限制所显示的连接工厂集合。
  3. 选择您要使用的连接工厂的名称。
在“常规属性”下有四组属性:
对“管理”、“连接”、“高级”和“安全”属性设置组进行任何必需的更改,然后单击应用以保存先前的配置,在内容窗格的“其他属性”下单击以下任何链接:

在“相关项”下面,单击 JAAS - J2C 认证数据,以配置要与连接工厂一起使用的认证信息。

可以使用 WebSphere MQ 管理命令指定下列其他属性: 有关这些属性的更多信息,请参阅createWMQConnectionFactory 命令。
注: 指定 WebSphere MQ 属性时,存在下列限制:

WebSphere MQ 统一连接工厂具有下列属性。

管理
作用域

应用程序可以看到此连接工厂定义所在的级别。

资源(如消息传递提供程序、名称空间绑定或共享库)可以在多个作用域上定义,在较特定的作用域上定义的资源覆盖较一般作用域上定义的重复项。

显示的作用域仅供参考,并且在该面板上不能被更改。如果您要在不同的作用域上浏览或更改其他资源,那么在“ WebSphere MQ 连接工厂集合”面板上更改作用域,然后单击应用,再单击该资源类型的相应链接。

数据类型 字符串
提供程序

创建队列连接工厂时所指定的 JMS 提供程序。

对于使用此面板的所有连接工厂,提供程序都是 WebSphere MQ 消息传递提供程序。

所显示的提供程序仅供参考。

数据类型 字符串
名称

在 WebSphere Application Server 中,为了进行管理而提供的用于识别此连接工厂的名称。

数据类型 字符串
范围 此名称在对单元定义的一组连接工厂中必须是唯一的。
JNDI 名称

用于将连接工厂绑定到 JNDI 名称空间的 JNDI 名称。

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

数据类型 字符串
描述

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

数据类型 字符串
缺省值 Null
连接

配置连接所需的信息取决于所选队列连接工厂是否是使用客户机通道定义表 (CCDT) 创建的。

如果所选连接工厂是使用 CCDT 创建的,那么仅显示以下属性:
  • 客户机通道定义表 URL
  • 队列管理器
  • SSL 配置
如果所选连接工厂不是使用 CCDT 创建的,那么会显示以下属性:
  • 队列管理器
  • 传输
  • 主机名
  • 端口
  • 服务器连接通道
  • 如果取消选中使用 SSL 来保护与 Websphere MQ 的通信属性的复选框,那么不能使用以下属性:
    • 集中管理
    • 特定配置
    • SSL 配置

有关设置 WebSphere MQ 的 SSL 属性的更多信息,请参阅 WebSphere MQ Using Java 一书中的 SSL properties 部分。

客户机通道定义表 URL

指定 WebSphere MQ CCDT 位置的 URL。

数据类型 字符串
队列管理器

如果指定的连接工厂基于 CCDT,那么使用此属性在 CCDT 中选择一个条目。否则,此属性指定要连接至的队列管理器或队列共享组的名称。与指定的 WebSphere MQ 资源建立了连接以发送或接收消息。

数据类型 字符串
范围 如果此连接工厂并不基于 CCDT,那么此值必须为有效的队列管理器名称。
如果此连接工厂基于 CCDT,那么此值必须为下列值之一:
  • 有效的队列管理器名称
  • 空白1
1当您以此格式指定队列管理器属性的值时(与 CCDT 配合使用),使用连接工厂建立的各个连接可以连接至不同的队列管理器。当 CCDT 包含具有匹配的队列管理器名称 (QMNAME) 参数的多个客户机连接通道定义时,可从多个队列管理器选择,并且这些连接通道定义定义不同队列管理器的网络连接详细信息。

全局事务不得使用配置为通过使用 CCDT 从多个队列管理器选择的连接工厂,因为事务管理器可能无法在失败后恢复全局事务。

传输

用于连接的 WebSphere MQ 传输类型。传输类型用来确定用于连接到 WebSphere MQ 的确切机制。

数据类型 下拉列表
缺省值 绑定方式优先于客户机方式
范围
客户机
使用基于 TCP/IP 的网络连接与 WebSphere MQ 队列管理器进行通信。
绑定方式优先于客户机方式
尝试以绑定方式连接至队列管理器。如果无法执行此操作,那么还是进行客户机传输。
绑定
与在同一节点上运行的队列管理器建立跨内存连接。下列“客户机传输方式”属性已被禁用:
  • 主机名
  • 端口
  • 服务器连接通道
有关配置传输类型绑定方式优先于客户机方式绑定的更多信息,请参阅对 WebSphere MQ 消息传递提供程序配置本机库信息和调整 WebSphere MQ 消息传递提供程序所使用的线程池的大小。

有关调整 WebSphere MQ 消息传递提供程序所使用的线程池大小的信息不与修订包 5 或更高版本相关,因为这些版本中已不再使用 WMQCommonServices 线程池。

主机名

要连接至的 WebSphere MQ 队列管理器的主机名、IPv4 或 IPv6 地址。

数据类型 字符串
端口

WebSphere MQ 正在侦听的端口号。

数据类型 整型
缺省值 1414
范围 值必须在 1 到 65536 范围内(也包含这两个数)。
服务器连接通道

连接至 WebSphere MQ 时使用的 WebSphere MQ 服务器连接通道名称。

数据类型 字符串
缺省值 SYSTEM.DEF.SVRCONN
范围 值必须是对所连接至的 WebSphere MQ 队列管理器定义的服务器连接通道。
使用 SSL 来保护与 WebSphere MQ 的通信

此选项确定是否使用 SSL(安全套接字层)协议来保护与 WebSphere MQ 队列管理器或队列共享组的网络通信。

在应用程序服务器环境中使用 WebSphere MQ 消息传递提供程序连接工厂时,应用程序服务器将管理 SSL 配置。要更改 SSL 配置参数,使用管理控制台浏览至安全性 > SSL 证书和密钥管理面板。

在客户机环境中使用 WebSphere MQ 消息传递提供程序连接工厂时,客户机将从 ssl.client.props 文件中获取 SSL 配置信息。在本主题的相关参考信息中详细说明了此文件的使用方法。

在 WebSphere MQ 消息传递提供程序连接工厂的 SSL 配置中只能使用一个密码套件。如果指定多个密码套件,那么将仅使用第一个密码套件。

数据类型 复选框。如果取消选中了此复选框,那么下列 SSL 属性将被禁用:
  • 集中管理
  • 特定配置
  • SSL 配置
集中管理

当使用 SSL 协议与 WebSphere MQ 进行通信时,选中此单选按钮以指定从集中管理的 WebSphere Application Server SSL 配置中获取 SSL 配置。

当您选择此单选按钮时,将使用 WebSphere MQ 消息传递提供程序连接工厂中的主机名和端口属性来选择适当的 SSL 配置。要提供将与该连接工厂相匹配的 SSL 配置,请参阅“相关参考”下面所列示的“动态出站端点 SSL 配置设置”主题。

数据类型 单选按钮
特定配置

如果想指定特定的 SSL 配置以供在使用 SSL 来保护与 WebSphere MQ 队列管理器或队列共享组的网络通信时使用,请选择此单选按钮。

数据类型 单选按钮
SSL 配置

使用 SSL 来保护与 WebSphere MQ 队列管理器或队列共享组的网络通信时要使用的 SSL 配置。

如果选中了集中管理单选按钮,并且显式定义了 WebSphere MQ 消息传递提供程序资源,那么将禁用此属性。

如果 WebSphere MQ 消息传递提供程序资源基于 CCDT,那么始终将启用此属性。

如果此 WebSphere MQ 消息传递提供程序资源基于 CCDT,那么仅当 CCDT 中的相关条目已配置为使用 SSL 时才会使用此参数。

此外,如果选择的 SSL 配置为 none,那么将使用 WebSphere MQ 消息传递提供程序的集中管理的缺省 WebSphere Application Server SSL 配置。

数据类型 下拉列表
高级
客户机标识

连接至 WebSphere MQ 消息传递提供程序时要指定的客户机标识。

数据类型 字符串
允许使用克隆的持久预订

用于确定不同的服务器是否可以同时访问一个持久预订的多个实例的选项。

数据类型 复选框
缺省值 已清除
范围
已选中
不同的服务器可以同时访问一个持久预订的多个实例。
已清除
不同的服务器不能同时访问一个持久预订的多个实例。
提供程序版本

WebSphere MQ 消息传递提供程序版本。此值用来确定是否连接至特定版本的队列管理器。它还用来确定客户机需要的功能类型。

注: 在修订包 5 之前,如果此连接工厂用于连接 WebSphere MQ z/OS 版系统上的队列管理器或队列共享组,请在提供程序版本属性中输入值 6.0.0.0。连接工厂必须使用此提供程序版本值,而无论其连接的 WebSphere MQ z/OS 的版本如何。

对于修订包 5 或更高版本,如果此连接工厂用于连接 WebSphere MQ for z/OS V7 系统上的队列管理器或队列共享组,请在提供程序版本属性中输入 6.0.0.0

对于修订包 7 或更高版本,已取消此对提供程序版本的限制。

数据类型 字符串
范围 输入的值必须是空字符串或采用以下某种格式:
  • n.n.n.n
  • n.n.n
  • n.n
  • n
其中 n 是大于或等于零的数字值。

例如 6.0.0.0。

支持分布式两阶段落实协议

用于指定连接工厂是否支持消息传递事务的 XA 协调的选项。如果要在同一事务中使用多个资源(包括此连接工厂),那么请启用此选项。

如果清除了此属性,请禁用对分布式两阶段落实协议的支持。JMS 会话仍可参与事务,但是它使用资源管理器本地事务调用 session.commitsession.rollback,而不是 XA 调用。这可以改进性能。然而,WebSphere Application Server 中仅单个资源能参与事务。

最后参与者支持使您能将一个非 XA 资源与其他有 XA 能力的资源协同参与。

数据类型 复选框
缺省值 已选中
范围
已选中
连接工厂支持使用分布式两阶段落实协议来协调事务性工作。
已清除
连接工厂不支持使用分布式两阶段落实协议来协调事务性工作。

如果事务涉及到其他资源(包括其他队列或主题),那么请保留此选项。仅当您确定作为此队列连接目标的队列管理器是该事务中的唯一资源时,才清除此选项。

安全性设置
用于 XA 恢复的认证别名

在 XA 恢复期间连接至 WebSphere MQ 时要使用的用户名和密码。

数据类型 下拉列表
缺省值 (无)
范围 已为单元定义的所有认证别名以及值“(无)”,此值指定在进行 XA 恢复期间不将任何凭证传递至 WebSphere MQ。
映射配置别名

仅当组件资源引用上没有登录配置时才使用此字段。

当资源权限值为“容器”时,用于定义认证策略的首选方法是通过在组件资源引用上指定登录配置和相关联属性来定义。

如果指定了 DefaultPrincipalMapping 登录配置,那么相关联的属性是一个 JAAS - J2C 认证数据条目别名。要配置与连接工厂配合使用的认证信息,在“相关项”下单击 JAAS - J2C 认证数据

数据类型 下拉列表
缺省值 (无)
范围
ClientContainer
WSLogin
WSKRB5Login
DefaultPrincipalMapping
TrustedConnectionMapping
KerberosMapping
容器管理的认证别名

用于指定在连接至 WebSphere MQ 消息传递提供程序时要使用的用户名和密码的认证别名。

数据类型 下拉列表
缺省值 (无)
范围 已为单元定义的所有认证别名以及值“(无)”,此值指定不将任何凭证传递至 WebSphere MQ。



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

相关概念
相关任务
相关参考
连接工厂集合
WebSphere MQ 库 Web 页面,网址为 http://www.ibm.com/software/ts/mqseries/library (在线)
WebSphere MQ 库 (在线)


文件名: umj_pjcfm.html