[Release 5.1 and later]WebSphere MQ 队列连接工厂设置

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

队列连接工厂用于创建到队列目标的 JMS 连接。队列连接工厂由 WebSphere MQ JMS 提供程序创建。WebSphere MQ JMS 提供程序的队列连接工厂具有下列属性。

注:

要查看此管理控制台页面,单击资源 -> WebSphere MQ JMS 提供程序 ->(在内容窗格中,“其它属性”下)WebSphere MQ 队列连接工厂 -> connection_factory

名称
在 IBM WebSphere Application Server 中出于管理目的,用于标识队列连接工厂的名称。此名称在跨 WebSphere 管理域的 JMS 连接工厂中是唯一的。
数据类型 String
JNDI 名称
用于将连接工厂绑定到应用程序服务器的名称空间的 JNDI 名称。

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

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

数据类型 String
描述
在 IBM WebSphere Application Server 中出于管理目的,对连接工厂的描述。
数据类型 String
缺省
类别
为了您的 IBM WebSphere Application Server 管理记录,用于分类或分组此连接工厂的类别。
数据类型 String
组件管理的认证别名
此别名指定用于认证连接到 JMS 提供程序的用户标识和密码,以进行应用程序管理的认证。

此属性提供已定义给 WebSphere Application Server 的 J2C 认证数据条目别名的列表。您可以选择数据条目别名,用它来认证创建的到 JMS 提供程序的新连接。

如果您为 WebSphere Application Server 启用了全局安全性,那么请选择别名,该别名指定用于认证创建的到 JMS 提供程序的新连接的用户标识和密码。此别名的使用取决于资源认证(res-auth)设置,它在应用程序组件的部署描述符的连接工厂资源引用中声明。

注:

  1. 长于 12 个字符的用户标识不能用于具有嵌入式 WebSphere JMS 提供程序的认证。例如,缺省 Windows NT 用户标识 Administrator 对于与嵌入式 WebSphere 消息传递一起使用是无效的,因为它包含 13 个字符。 因此,WebSphere JMS 提供程序连接工厂的认证别名必须指定不多于 12 个字符的用户标识。
  2. 当使用绑定传输方式时,如果您要使用 WebSphere MQ JMS 提供程序 JMS 连接,则在 WebSphere MQ 队列连接工厂上设置 Transport type=BINDINGS。您也必须选择以下选项之一:
    • 要使用安全性凭证,确保指定的用户是 WebSphere Application Server 进程的当前登录的用户。如果指定的用户不是 WebSphere Application Server 进程的当前登录的用户,则 WebSphere MQ JMS 绑定认证抛出"为 MQQueueManager 提供了 MQJMS2013 无效安全性认证"错误。
    • 不要指定安全性凭证。在 WebSphere MQ 连接工厂上,确保未设置组件管理的认证别名容器管理的认证别名属性。

容器管理的认证别名
此别名指定用于认证连接到 JMS 提供程序的用户标识和密码,以进行容器管理的认证。

此属性提供已定义给 WebSphere Application Server 的 J2C 认证数据条目别名的列表。您可以选择数据条目别名,用它来认证创建的到 JMS 提供程序的新连接。

如果您为 WebSphere Application Server 启用了全局安全性,那么请选择别名,该别名指定用于认证创建的到 JMS 提供程序的新连接的用户标识和密码。此别名的使用取决于资源认证(res-auth)设置,它在应用程序组件的部署描述符的连接工厂资源引用中声明。

注:

  1. 长于 12 个字符的用户标识不能用于具有嵌入式 WebSphere JMS 提供程序的认证。例如,缺省 Windows NT 用户标识 Administrator 对于与嵌入式 WebSphere 消息传递一起使用是无效的,因为它包含 13 个字符。 因此,WebSphere JMS 提供程序连接工厂的认证别名必须指定不多于 12 个字符的用户标识。
  2. 当使用绑定传输方式时,如果您要使用 WebSphere MQ JMS 提供程序 JMS 连接,则在 WebSphere MQ 队列连接工厂上设置 Transport type=BINDINGS。您也必须选择以下选项之一:
    • 要使用安全性凭证,确保指定的用户是 WebSphere Application Server 进程的当前登录的用户。如果指定的用户不是 WebSphere Application Server 进程的当前登录的用户,则 WebSphere MQ JMS 绑定认证抛出"为 MQQueueManager 提供了 MQJMS2013 无效安全性认证"错误。
    • 不要指定安全性凭证。在 WebSphere MQ 连接工厂上,确保未设置组件管理的认证别名容器管理的认证别名属性。

Queue Manager
此连接工厂的 WebSphere MQ Queue Manager 名。此工厂创建的连接连接到此 Queue Manager。
数据类型 String
缺省
范围 有效的 WebSphere MQ Queue Manager 名,从 1 到 48 个 ASCII 字符
主机
运行 WebSphere MQ Queue Manager 的主机名,仅用于客户机连接。
数据类型 String
缺省
范围 有效的 TCP/IP 主机名
端口
仅对于客户机连接,用于到 WebSphere MQ Queue Manager 的连接的 TCP/IP 端口号。

必须在 WebSphere MQ Queue Manager 上配置此端口。

数据类型 整型
缺省
范围 有效的 TCP/IP 端口号,在 WebSphere MQ Queue Manager 上配置。
通道
仅对于客户机连接,用于到 WebSphere MQ Queue Manager 的连接的通道名。
数据类型 String
缺省
范围 1 到 20 个 ASCII 字符
传送类型
指定是 WebSphere MQ 客户机连接,还是 JNI 绑定用于到 WebSphere MQ Queue Manager 的连接。外部 JMS 提供程序控制 JMS 客户机和 JMS 服务器之间的通信协议。当您使用非 ASF 非持久性、非耐久性、非事务性消息传递,或者当您要满足安全性问题,而客户机对于 Queue Manager 节点是本地时,调整传输类型。
数据类型 枚举
单位 不适用
缺省 BINDINGS
范围
BINDINGS
JNI 绑定用于连接到 Queue Manager。BINDINGS 是共享的内存协议,只能用在 Queue Manager 和 JMS 客户机位于同一节点上,而且具有相同的安全性风险(应该通过使用 EJB 角色来处理)时。

当使用绑定传输方式时,如果您要使用 WebSphere MQ JMS 提供程序 JMS 连接,则在 WebSphere MQ 队列连接工厂上设置 Transport type=BINDINGS。您也必须选择以下选项之一:

  • 要使用安全性凭证,确保指定的用户是 WebSphere Application Server 进程的当前登录的用户。如果指定的用户不是 WebSphere Application Server 进程的当前登录的用户,则 WebSphere MQ JMS 绑定认证抛出"为 MQQueueManager 提供了 MQJMS2013 无效安全性认证"错误。
  • 不要指定安全性凭证。在 WebSphere MQ 连接工厂上,确保未设置组件管理的认证别名容器管理的认证别名属性。

CLIENT
WebSphere MQ 客户机连接用于连接到 Queue Manager。CLIENT 是典型的基于 TCP 协议。
DIRECT
对于使用 DIRECT 方式的 WebSphere MQ 事件代理。DIRECT 是轻量级套接字协议,用于非事务性、非耐久性和非持久性 Publish/Subscribe 消息传递。 DIRECT 仅作用于使用非 ASF 协议的客户机和消息驱动 bean。
QUEUED
QUEUED 是标准 TCP 协议。
建议
队列连接工厂传输类型
BINDINGS 可加快 30% 或更多,但是它缺乏安全性。当您具有安全性注意事项时,BINDINGS 比 CLIENT 更合适。
主题连接工厂传输类型
DIRECT 是最快速的,应该尽可能的使用。当您要满足其它安全性任务,而且 Queue Manager 对于 JMS 客户机是本地时,使用 BINDINGS。QUEUED 是所有其它情况的候补。注意,当带有 DIRECT 设置的 CSD2 之前的 WebSphere MQ 5.3 与消息驱动 bean 一起使用并处于欠载状态时,可丢失消息。这还发生在基于客户机端应用程序时,除非代理的 maxClientQueueSize 设置为 0。您可使用命令 #wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID 将其设置为 0,其中 executionGroupUUID 可通过启动代理并查看事件 2201 的事件日志/应用程序找到。此值通常是 ffffffff-0000-0000-000000000000。
模型队列定义
当请求的队列不存在时,Queue Manager 可用于创建临时队列的模型队列定义名。
数据类型 String
缺省
范围 1 到 48 个 ASCII 字符
客户机标识
用于到 WebSphere MQ Queue Manager 的连接的 JMS 客户机标识。
数据类型 String
缺省
CCSID
与 WebSphere MQ Queue Manager 一起使用的编码字符集标识。

此编码字符集标识(CCSID)必须是 WebSphere MQ 所支持 CCSID 之一。

数据类型 String
单位 整型
缺省
范围 1 到 65535

要获取有关所支持 CCSID 以及有关在消息数据之间从一个已编码字符集转换到另一个字符集的更多信息,请参阅 WebSphere MQ System AdministrationWebSphere MQ Application Programming Reference 书籍。 这些可从 WebSphere MQ 消息传递多平台和平台特定书籍的 Web 页面(例如,仅当此主题链接到万维网时可以访问目标   http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html )、仅当此主题链接到万维网时可以访问目标   IBM 出版物中心 或 WebSphere MQ collection kit,SK2T-0730 中获得。

消息保留
选择此记号框,以指定在队列上保留不要的消息。否则,根据不要消息的配置选项处理它们。
数据类型 枚举
单位 不适用
缺省 已清除
范围
已选择
在队列上保留不要的消息。
已清除
根据不要消息的配置选项处理它们。
启用 XA
指定连接工厂是用于消息的 XA 还是非 XA 坐标,并控制应用程序服务器是否使用 XA QCF/TCF。如果同一事务中未使用多个资源,则启用 XA。

如果您设置此属性为 NON_XA,JMS 会话仍参与事务中,但使用资源管理器本地事务调用(session.commit 和 session.rollback)而不是 XA 调用。这可以改进性能。然而,这意味着在 WebSphere Application Server 中仅单个资源能参与事务。在 WebSphere Application Server Enterprise 中,最后参与者支持使一个非 XA 资源与其它有 XA 能力的资源一起参与。

对于 Port 属性设置为 DIRECT 的 WebSphere 主题连接工厂,此属性不适用,且总是采用值 NON_XA

数据类型 枚举
单位 不适用
缺省 启用 XA
范围
XA
此连接工厂用于消息的 XA 坐标
NON_XA
此连接工厂用于消息的非 XA 坐标
建议 当接收的消息队列或主题仅是事务中的资源时,不要启用 XA。 当涉及其它资源(包含其它队列或主题)时,启用 XA。
连接池
指定连接池设置的可选集合。

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

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

如果对 JMS 资源的并发服务器端访问超出缺省值,则更改连接池的大小。在每个队列或主题基础上设置连接池的大小。请参阅下表,以获得详细信息。

会话池
会话池设置的可选集合。

此链接提供对所有 J2C 连接器共有的可选连接池属性的面板。

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

定制属性
传递到 WebSphere MQ 的定制属性的名称和值对的可选集合。

您可以使用“定制”属性页定义以下 WebSphere MQ 安全套接字层(SSL)属性。这些特性仅当您设置属性为 Transport type=CLIENT 时应用。

要获取更多关于设置这些属性的信息,请参阅《WebSphere MQ Using Java》一书中的 SSL 属性部分。