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

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

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

要查看 IBM MQ 主题连接工厂设置,请使用管理控制台来完成下列步骤:
  1. 在导航窗格中,单击资源 > JMS->主题连接工厂以显示现有主题连接工厂。
  2. 如果合适的话,在内容窗格中,将作用域设置更改为定义主题连接工厂所在的级别。这将限制所显示的主题连接工厂集合。
  3. 选择您要使用的主题连接工厂的名称。
在“常规属性”下有四组属性:
对“管理”、“连接”、“高级”和“安全”属性设置组进行任何必需的更改,然后单击应用以保存先前的配置,在内容窗格的“其他属性”下单击以下任何链接:
  • 单击高级属性以显示 IBM MQ 主题连接工厂的高级属性。
  • 单击代理属性以显示 IBM MQ 主题连接工厂的代理属性。
  • 单击定制属性以显示 IBM MQ 主题连接工厂的定制属性。
  • 单击客户机传输属性以显示或更改 IBM MQ 主题连接工厂的客户机传输属性。如果所选主题连接工厂不是使用客户机通道定义表 (CCDT) 创建的,那么遵循此链接以输入连接至 IBM MQ 所需的所有信息。 如果所选主题连接工厂是使用 CCDT 创建的,那么无需提供客户机传输属性,因此也不会提供此链接。
  • 单击连接池以显示 IBM MQ 主题连接工厂的连接池详细信息
  • 单击会话池以显示 IBM MQ 主题连接工厂的会话池详细信息。

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

可以使用 WebSphere® MQ 管理命令指定下列其他属性:
  • -localAddress
  • -clonedSubs
  • -componentAuthAlias

有关这些属性的更多信息,请参阅createWMQConnectionFactory 命令

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

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

管理

作用域

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

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

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

信息
数据类型 字符串

提供程序

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

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

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

信息
数据类型 字符串

名称

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

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

JNDI 名称

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

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

信息
数据类型 字符串

描述

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

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

连接

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

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

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

客户机通道定义表 URL

指定 IBM MQ CCDT 位置的 URL。

信息
数据类型 字符串

队列管理器

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

信息
数据类型 字符串
范围 如果此主题连接工厂并不基于 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 地址。

信息
数据类型 字符串

端口

IBM MQ 正在侦听的端口号。

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

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

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

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

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

信息
数据类型 单选按钮

连接名称列表

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

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

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

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 或更高版本时,此属性才可用。

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

服务器连接通道

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

信息
数据类型 字符串
缺省值 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 来保护与 IBM MQ 队列管理器或队列共享组的网络通信时要使用的 SSL 配置。

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

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

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

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

信息
数据类型 下拉列表

高级

客户机标识

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

信息
数据类型 字符串

允许使用克隆的持久预订

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

信息
数据类型 复选框
缺省值 未选中
范围
已选中
不同的服务器可以同时访问一个持久预订的多个实例。
未选中
不同的服务器不能同时访问一个持久预订的多个实例。

提供程序版本

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

信息
数据类型 字符串
范围 输入的值必须是空字符串或采用以下某种格式:
  • 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。

安全性设置

用于 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_ptcfm
文件名:umj_ptcfm.html