IBM MQ 消息传递提供程序队列连接工厂设置

使用此面板查看或更改所选队列连接工厂的配置属性,以供 IBM MQ 消息传递提供程序使用。这些配置属性控制如何创建与相关联 JMS 队列目标的连接。

IBM MQ 队列连接工厂用于与 IBM MQ 所提供的队列建立 JMS 连接,以进行发布/预订消息传递。

要查看 IBM MQ 队列连接工厂设置,请使用管理控制台来完成下列步骤:
  1. 在导航窗格中,单击资源 > JMS->队列连接工厂以显示现有的队列连接工厂。
  2. 如果合适的话,在内容窗格中,将范围设置更改为定义队列连接工厂所在的级别。这将限制所显示的队列连接工厂集合。
  3. 选择您要使用的队列连接工厂的名称。
在“常规属性”下有四组属性:

对“管理”、“连接”、“高级”和“安全”属性设置组进行任何必需的更改,然后单击应用以保存先前的配置,在内容窗格的“其他属性”下选择以下任何链接:

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

可以使用 IBM MQ 管理命令指定下列其他属性:
  • -localAddress
  • -componentAuthAlias
有关这些属性的更多信息,请参阅createWMQConnectionFactory 命令
注: 指定 IBM MQ 属性时,存在下列限制:
  • 名称的最大长度为 48 个字符,但通道名例外,它的最大长度为 20 个字符。
  • 指定的属性值必须与您配置 JMS 资源的 IBM MQ 时指定的值匹配。有关配置 IBM MQ JMS 资源的更多信息,请参阅 IBM MQ IBM Knowledge Center 的“使用 Java™”和“系统管理”部分。

IBM MQ 队列连接工厂具有下列属性。

管理

范围

应用程序可以看到此资源定义的级别。

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

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

信息
数据类型 String

提供程序

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

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

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

信息
数据类型 String

名称

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

信息
数据类型 String
范围 此名称在对单元定义的一组队列连接工厂中必须是唯一的。

JNDI 名称

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

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

信息
数据类型 String

描述

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

信息
数据类型 String
缺省 Null

连接

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

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

有关为 IBM MQ 设置 SSL 属性的更多信息,请参阅 IBM MQ IBM Knowledge Center 的“使用 Java”部分中的“SSL 属性”

客户机通道定义表 URL

指定 IBM MQ CCDT 位置的 URL。

信息
数据类型 String

队列管理器

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

信息
数据类型 String
范围 如果此队列连接工厂并不基于 CCDT,那么此值必须是有效的队列管理器名称。
如果此队列连接工厂基于 CCDT,那么此值必须为下列值之一:
  • 有效的队列管理器名称
  • 星号 (*) 后跟队列管理器组名称1
  • 星号 (*)
  • 空白1
1当您以此格式指定队列管理器属性的值时(与 CCDT 配合使用),使用队列连接工厂建立的各个连接可以连接至不同的队列管理器。当 CCDT 包含具有匹配的队列管理器名称 (QMNAME) 参数的多个客户机连接通道定义时,可从多个队列管理器选择,并且这些连接通道定义定义不同队列管理器的网络连接详细信息。
如果指定的连接工厂基于 CCDT,并且该 CCDT 可从多个队列管理器中选择,那么您可能无法恢复全局事务。因此,对于指定 CCDT 的连接工厂,您有两个选择:
  • 在指定“队列管理器”属性时,避免关于目标队列管理器的任何多义性,这意味着此属性的指定值不能包含星号 (*)。
  • 避免使用含有参与全局事务的应用程序的资源。

传输

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

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

分别以主机值和端口值的形式输入主机和端口信息

如果选中此单选按钮,那么表示与 IBM MQ 队列管理器的连接是使用主机名和端口属性提供的信息来建立的。

选择此选项会启用主机名和端口属性,并会禁用连接名称列表属性。要输入连接名称列表信息,请单击以连接名称列表的形式输入主机和端口信息

仅当范围属性指定单元或集群,或者范围属性指定节点或服务器,并且该节点或服务器正在运行 WebSphere Application Server V8.0 或更高版本时,此单选按钮才可用。

信息
数据类型 单选按钮

主机名

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

信息
数据类型 String

端口

IBM MQ 正在侦听的端口号。

信息
数据类型 整数
缺省 1414
范围 值必须在 1 到 65536 范围内(包括 1 和 65536)。

以连接名称列表的形式输入主机和端口信息

如果选中此单选按钮,那么表示与 IBM MQ 队列管理器的连接是使用连接名称列表属性提供的信息来建立的。

可以使用连接名称列表来连接至单个队列管理器或多实例队列管理器。有关使用多实例队列管理器的更多信息,请参阅 IBM MQ 信息中心。选择此选项会启用连接名称列表属性,并会禁用主机名和端口属性。要输入独立的主机和端口信息,请单击分别以主机值和端口值的形式输入主机和端口信息

仅当范围属性指定单元或集群,或者范围属性指定节点或服务器,并且该节点或服务器正在运行 WebSphere Application Server V8.0 或更高版本时,此单选按钮才可用。

信息
数据类型 单选按钮

连接名称列表

这是连接名称列表,它指定当您希望连接工厂连接至多实例队列管理器时要使用的主机名和端口详细信息。

此属性只能用于允许连接至多实例队列管理器。它不能用于允许连接到非多实例队列管理器,因为该操作会导致事务完整性问题。

信息
数据类型 String
缺省 取消设置
范围 必须将此字段设置为以下形式的字符串:

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

端口信息是可选的,如果未指定,那么缺省值是 1414。

host 必须是有效的 TCP/IP 主机名或 IPv4 或 IPv6 地址。

port 必须是 1 到 65536 范围内(包括 1 和 65536)的整数值。

例如:localhost(1234),remotehost1(1234),remotehost2

指定连接名称列表属性时,会自动将主机名或端口属性设置为连接名称列表中第一个项目的主机名和端口号。因此,如果指定 localhost(1234),remotehost1(1234),remotehost2,那么会将主机名设置为 localhost,将端口设置为 1234。

仅当范围属性指定单元或集群,或者范围属性指定节点或服务器,并且该节点或服务器正在运行 WebSphere Application Server V8.0 或更高版本时,此属性才可用。

在混合单元环境中使用时,连接名称列表属性中的信息无法用于 WebSphere Application Server V8.0 之前的版本。在这种情况下,改为使用基于连接名称列表中第一个元素的主机名和端口名字段中的信息。

服务器连接通道

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

信息
数据类型 String
缺省 SYSTEM.DEF.SVRCONN
范围 值必须是对所连接至的 IBM MQ 队列管理器定义的服务器连接通道。

使用 SSL 来保护与 IBM MQ 的通信

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

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

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

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

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

集中管理

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

当您选中此单选按钮时,将使用 IBM MQ 消息传递提供程序连接工厂中的主机名和端口属性来选择适当的 SSL 配置。 如果通过连接名称列表提供主机和端口信息,那么意味着会使用列表中第一个元素的主机名和端口信息来选择适当的 SSL 配置。 要提供将与该连接工厂相匹配的 SSL 配置,请参阅“相关参考”下面所列示的“动态出站端点 SSL 配置设置”主题。

信息
数据类型 单选按钮

特定配置

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

信息
数据类型 单选按钮

SSL 配置

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

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

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

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

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

信息
数据类型 下拉列表

高级

客户机标识

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

信息
数据类型 String

提供程序版本

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

信息
数据类型 String
范围 输入的值必须是空字符串或采用以下某种格式:
  • 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 恢复期间连接至 IBM MQ 时要使用的用户名和密码。

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

映射配置别名

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

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

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

信息
数据类型 下拉列表
缺省 (无)
范围 提供了下列选项:
  • ClientContainer
  • WSLogin
  • WSKRB5Login
  • DefaultPrincipalMapping
  • TrustedConnectionMapping
  • KerberosMapping

容器管理的认证别名

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

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

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



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