[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 中出于管理目的,用于标识主题连接工厂的名称。此名称在 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)设置,它在应用程序组件的部署描述符的连接工厂资源引用中声明。

注: 长于 12 个字符的用户标识不能用于具有嵌入式 WebSphere JMS 提供程序的认证。例如,缺省 Windows NT 用户标识 Administrator 对于与嵌入式 WebSphere 消息传递一起使用是无效的,因为它包含 13 个字符。 因此,WebSphere JMS 提供程序连接工厂的认证别名必须指定不多于 12 个字符的用户标识。

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

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

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

注: 长于 12 个字符的用户标识不能用于具有嵌入式 WebSphere JMS 提供程序的认证。例如,缺省 Windows NT 用户标识 Administrator 对于与嵌入式 WebSphere 消息传递一起使用是无效的,因为它包含 13 个字符。 因此,WebSphere JMS 提供程序连接工厂的认证别名必须指定不多于 12 个字符的用户标识。

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 角色来处理)时。
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。
代理控制队列
代理控件队列的名称,所有命令消息(除了出版物和要删除出版物的请求外)都发送至此队列

代理控件队列的名称。发布商和订户应用程序,以及其它代理将所有命令消息(除了出版物和要删除出版物的请求外)发送至此队列。

数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
代理 Queue Manager
提供发布/预订消息代理的 WebSphere MQ Queue Manager 的名称。
数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
代理出版物队列
接收缺省流的所有出版物消息的代理输入队列的名称

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

数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
代理预订队列
从中检索非耐久预订消息的代理队列名

从中检索非耐久预订消息的代理队列名。订户在注册预订时,指定队列名。

数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
代理 CC 预订队列
从中为 ConnectionConsmer 检索非耐久预订消息的代理队列的名称。此属性仅应用于 Web 容器的使用。

从中为 ConnectionConsmer 检索非耐久预订消息的代理队列的名称。此属性仅应用于 Web 容器的使用。

数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
代理版本
消息代理是由 WebSphere MQ MA0C Supportpac 还是由更新版本的 WebSphere 消息代理产品提供
数据类型 枚举
单位 不适用
缺省 高级
范围
高级
消息代理由更新版本的 WebSphere 消息代理产品(如 WebSphere MQ Integrator 和 EventBroker)提供。
基本
消息代理由 WebSphere MQ MA0C SupportPac(MQSeries - Publish/Subscribe)或者以 MA0C 兼容方式工作的 MQSI 提供。
模型队列定义
当流队列不存在时,代理可用于创建非缺省流的动态队列的模型队列定义名

代理可用于创建动态队列,以接收不同于缺省流的流的出版物的模型队列定义名。仅当流队列不存在时才使用它。如果此模型队列定义不存在,则必须由管理员定义所有流队列。

数据类型 String
单位 美国英语 ASCII 字符
缺省
范围 1 到 48 个 ASCII 字符
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 中获得。

克隆支持
选择此复选框启用克隆支持以允许跨越主题克隆的相同耐久性预订。
数据类型 枚举
单位 不适用
缺省 已清除
范围
已选择
启用克隆支持。
已清除
禁用克隆支持。

如果您选择此属性,您还必须指定客户机标识属性的值。

客户机标识
用于到 Queue Manager 的连接的 JMS 客户机标识。
数据类型 String
范围 有效的 JMS 客户机标识,如 ASCII 字符
启用 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 属性。这些特性仅当您设置属性为 Transport type=CLIENT 时应用。

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