IBM MQ 消息传递提供程序激活规范设置
使用此面板查看或更改所选激活规范的配置属性,以与 IBM MQ MQ 消息传递提供程序配合使用。这些配置属性控制如何创建与相关联队列和主题的连接。
- 在导航窗格中,单击以显示现有激活规范。
- 如果合适的话,在内容窗格中,将范围设置更改为定义激活规范所在的级别。这将限制所显示的激活规范集合。
- 选择您要使用的激活规范的名称。
- 单击高级属性以显示或更改 IBM MQ 激活规范的高级属性。
- 单击代理属性以显示或更改 IBM MQ 激活规范的代理属性。
- 单击定制属性以显示或更改 IBM MQ 激活规范的定制属性。例如,可以使用此选项来设置激活规范的定制属性 WAS_EndpointInitialState。WAS_EndpointInitialState 确定消息消耗是否在一旦使用激活规范供消息驱动的 Bean 与目标连接时,从 JMS 目标开始。
- 单击客户机传输属性以显示或更改 IBM MQ 激活规范的客户机传输属性。如果所选激活规范不是使用客户机通道定义表 (CCDT) 创建的,那么遵循此链接以输入连接至 IBM MQ 所需的所有信息。如果所选激活规范是使用 CCDT 创建的,那么无需提供客户机传输属性,因此也不会提供此链接。
在“相关项”下,可以单击 JAAS - J2C 认证数据,以配置要和激活规范配合使用的认证信息。
也可以使用 createWMQActivationSpec IBM MQ 管理命令来指定 -localAddress 属性。
- 名称的最大长度为 48 个字符,但通道名例外,它的最大长度为 20 个字符。
- 指定的属性值必须与您配置 JMS 资源的 IBM MQ 时指定的值匹配。有关更多信息,请参阅 IBM MQ 信息中心的使用 Java 和系统管理部分。
如果已在会影响此 IBM MQ 消息传递提供程序资源的作用域中禁用 IBM MQ 功能,那么会显示指出已禁用 IBM MQ 的参考消息。在单服务器环境中,仅当在禁用 IBM MQ 功能之后重新启动服务器时,才会显示此参考消息。在 Network Deployment 环境中,会立即显示此参考消息。
IBM MQ 激活规范具有下列属性。
管理
范围
应用程序可以看到此资源定义的级别。
资源(如消息传递提供程序、名称空间绑定或共享库)可以在多个范围上定义,在较特定的范围上定义的资源覆盖较一般范围上定义的重复项。
显示的范围仅供参考,并且不能在此面板上进行更改。如果您要在不同的范围上浏览或更改此资源(或其他资源),那么在“IBM MQ 激活规范集合”面板上更改范围,然后单击应用,再单击该资源类型的相应链接。
信息 | 值 |
---|---|
数据类型 | String |
提供程序
创建激活规范时所指定的 JMS 提供程序。
对于使用此面板创建的所有激活规范,提供程序都是 IBM MQ 消息传递提供程序。
所显示的提供程序仅供参考。
信息 | 值 |
---|---|
数据类型 | String |
名称
在 WebSphere Application Server 中,为了进行管理而提供的用于识别此激活规范的名称。
信息 | 值 |
---|---|
数据类型 | String |
范围 | 此名称在对单元定义的一组激活规范中必须是唯一的。 |
JNDI 名称
用于将激活规范绑定到 JNDI 名称空间的 JNDI 名称。
按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。
信息 | 值 |
---|---|
数据类型 | String |
描述
在 WebSphere Application Server 中,为了进行管理而提供的对此激活规范的描述。
信息 | 值 |
---|---|
数据类型 | String |
缺省 | Null |
连接
配置连接所需的信息取决于所选激活规范是否是使用客户机通道定义表 (CCDT) 创建的。
- 客户机通道定义表 URL
- 队列管理器
- SSL 配置
- 队列管理器
- 传输
- 如果已选中分别以主机值和端口值的形式输入主机和端口信息,那么无法使用连接名称列表属性,可以使用以下属性:
- 主机名
- 端口
- 如果已选中以连接名称列表的形式输入主机和端口信息,那么可以使用连接名称列表属性,但是无法使用以下属性:
- 主机名
- 端口
- 服务器连接通道
- 如果取消选中使用 SSL 来保护与 IBM MQ 的通信属性的复选框,那么不能使用以下属性:
- 集中管理
- 特定配置
- SSL 配置
有关为 IBM MQ 设置 SSL 属性的更多信息,请参阅 IBM MQ 信息中心的“IBM MQ 使用 Java™”部分中的“SSL 属性”。
- maxConnections
- connectionConcurrency(设置此属性仅影响 WebSphere Application Server 7 的节点。该属性对 WebSphere Application Server V8 或更高版本的节点没有影响。)
- reconnectionRetryCount
- reconnectionRetryInterval
客户机通道定义表 URL
指定 IBM MQ CCDT 位置的 URL。
信息 | 值 |
---|---|
数据类型 | String |
队列管理器
如果指定的激活规范基于 CCDT,那么使用此属性来选择 CCDT 中的一个条目。否则,此属性指定要连接至的队列管理器或队列共享组的名称。与指定的 IBM MQ 资源建立了连接以接收消息。
信息 | 值 |
---|---|
数据类型 | String |
范围 | 如果此激活规范并不基于 CCDT,那么此值必须为有效的队列管理器名称。 如果此激活规范基于 CCDT,那么此值必须为下列值之一:
如果指定的连接工厂基于
CCDT,并且该 CCDT 可从多个队列管理器中选择,那么您可能无法恢复全局事务。因此,对于指定
CCDT 的连接工厂,您有两个选择:
|
传输
用于连接的 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 V7.0 Fix Pack 7 或更高版本修订包级别运行的节点,可以使用连接名称列表属性来连接至多实例队列管理器。
- 对于在 V7.0 以前修订包级别运行的节点,无法识别连接名称列表属性,会输出类似以下示例的警告消息:
在这种情况下,会使用主机名和端口属性中的信息来连接到队列管理器。[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W J2CA0008W: Class com.ibm.mq.connector.inbound.ActivationSpecImpl used by resource cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 did not contain method setConnectionNameList. Processing continued.
服务器连接通道
在连接到 IBM MQ 时所用的 IBM MQ 服务器连接通道名称。
信息 | 值 |
---|---|
数据类型 | String |
缺省 | SYSTEM.DEF.SVRCONN |
范围 | 值必须是对所连接至的 IBM MQ 队列管理器定义的服务器连接通道。 |
使用 SSL 来保护与 IBM MQ 的通信
此选项确定是否使用 SSL(安全套接字层)协议来保护与 IBM MQ 队列管理器或队列共享组的网络通信。
在应用程序服务器环境中使用 IBM MQ 消息传递提供程序激活规范时,应用程序服务器将管理 SSL 配置。要更改 SSL 配置参数,使用管理控制台浏览至 面板。
在 IBM MQ 消息传递提供程序激活规范的 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 配置。
信息 | 值 |
---|---|
数据类型 | 下拉列表 |
目标
目标 JNDI 名称
JMS 目标的 JNDI 名称,要将此 JMS 目标中的消息传递给被配置为使用此激活规范的消息驱动的 Bean (MDB)。
信息 | 值 |
---|---|
数据类型 | String |
消息选择器
一种消息选择器表达式,它指定要传递哪些消息。
信息 | 值 |
---|---|
数据类型 | String |
目标类型
要使用其中的消息的目标(队列或主题)的类型。
信息 | 值 |
---|---|
数据类型 | 下拉列表 |
范围 |
|
持久预订
用于指定是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB 的选项。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省 | 未选中(非持久) |
范围 |
|
预订名称
持久预订的名称。仅当选中了持久预订复选框时此项才可用。
信息 | 值 |
---|---|
数据类型 | String |
高级
客户机标识
连接至 IBM MQ 消息传递提供程序时要指定的客户机标识。
信息 | 值 |
---|---|
数据类型 | String |
允许使用克隆的持久预订
用于确定不同的服务器是否可以同时访问一个持久预订的多个实例的选项。
信息 | 值 |
---|---|
数据类型 | 复选框 |
缺省 | 未选中 |
范围 |
|
提供程序版本
IBM MQ 消息传递提供程序版本。此值用来确定是否连接至特定版本的队列管理器。它还用来确定客户机需要的功能类型。
信息 | 值 |
---|---|
数据类型 | String |
范围 | 输入的值必须是空字符串或采用以下某种格式:
例如 6.0.0.0。 |
安全性设置
认证别名
连接至 IBM MQ 时要使用的用户名和密码。
信息 | 值 |
---|---|
数据类型 | 下拉列表 |
缺省 | (无) |
范围 | 已为单元定义的所有认证别名以及值“(无)”,此值指定不将任何凭证传递至 IBM MQ。 |