JMS 激活规范 [设置]

要在控制台中查看此页面,请单击下列其中一个操作途径:
  • 资源 -> JMS -> 激活规范 -> activation_specification_name
  • 资源 -> JMS -> JMS 提供程序 -> a_messaging_provider -> [其他属性] 激活规范 -> activation_specification_name
使用此面板浏览或更改所选 JMS 激活规范的配置属性,以与缺省消息传递提供程序配合使用。

如果您希望使用消息驱动的 Bean 通过 Java™ EE 连接器体系结构 (JCA) 1.5 与缺省消息传递提供程序通信,请创建 JMS 激活规范。JCA 提供 WebSphere® Application Server 之类的应用程序服务器与企业信息系统之间的 Java 连接。它提供将 JMS 提供程序与 Java EE 应用程序服务器集成的标准化方式,并提供与企业系统交换数据的框架,其中数据是以消息形式传输的。

对于除名称JNDI 名称目标 JNDI 名称目标查找认证别名以外的所有激活规范配置属性,这些属性将由相关联 EJB 2.1 或更高版本消息驱动的 Bean 的部署描述符中进行了适当命名的激活配置属性覆盖。对于 EJB 2.0 消息驱动的 Bean,目标类型预订耐久性确认方式消息选择器属性被部署描述符中的对应元素覆盖。对于任意类型的 Bean,目标 JNDI 名称目标查找属性可由消息驱动的 Bean 绑定中指定的值覆盖。

激活规范属性会影响缺省消息传递提供程序如何选择消息驱动的 Bean 应用程序连接至的消息传递引擎。缺省情况下,该环境自动将应用程序连接至总线上的可用消息传递引擎。但是,可指定额外的配置详细信息来影响连接进程;例如,标识特殊引导服务器、将连接范围限制为某个可用消息传递引擎子组、改进可用性或性能或者确保顺序处理接收的消息。 有关执行此操作的原因和方式的信息,请参阅“JMS 应用程序连接至总线上的消息传递引擎的方式”主题。

“配置”选项卡

“配置”选项卡显示此对象的配置属性。这些属性值将被保存下来,即使停止并重新启动运行时环境也是如此。请参阅信息中心任务描述以获取关于如何将配置更改应用于运行时环境的信息。

常规属性

范围

指定使应用程序服务器可使用此资源对象的最高拓扑级别。

信息
必需
数据类型 字符串

提供程序

指定 JMS 提供程序,它将启用基于 Java 消息服务 (JMS) 的异步消息传递。它提供了 J2EE 连接工厂,用于为特定 JMS 队列或主题目标创建连接。JMS 提供程序管理对象用于为相关 JMS 提供程序管理 JMS 资源。

信息
必需
数据类型 字符串

名称

资源的必需显示名称。

信息
必需
数据类型 字符串

JNDI 名称

资源的 JNDI 名称。

输入在与此激活规范相关联的消息驱动的 Bean 绑定中指定的 JNDI 名称。
信息
必需
数据类型 字符串

描述

资源的可选描述。

信息
必需
数据类型 文本区域

目标类型

信息
必需
数据类型 下拉列表
范围
队列
消息驱动的 Bean 使用 JMS 队列。请在目标 JNDI 名称属性中指定 JMS 队列的 JNDI 名称。

主题
消息驱动的 Bean 使用 JMS 主题。请在目标 JNDI 名称属性中指定 JMS 主题的 JNDI 名称。

目标查找

输入消息驱动的 Bean 用于在 JNDI 名称空间中查找 JMS 目标的 JNDI 名称。

目标类型 属性上选择目标的类型。

对于支持 JMS 的资源适配器,您必须将 javax.jms.Destinations 与某个激活规范相关联,以便该资源适配器能够为来自 JMS 目标的消息提供消息。在这种情况下,管理员应配置用于实现 javax.jms.Destination 接口的 J2C 受管对象并将其绑定至 JNDI。

可将 J2C 受管对象配置为使用实现 setDestination(javax.jms.Destination) 方法的 ActivationSpec 类。在这种情况下,可指定目标查找(即,实现 javax.jms.Destination 的 J2C 受管对象的 JNDI 名称)。

在应用程序启动期间,当激活规范作为端点激活的一部分初始化时,服务器使用目标查找来查找目标受管对象,然后在激活规范实例上设置该对象。
注: 在较低版本的 WebSphere Application Server 中,目标查找属性称为目标 JNDI 名称。在 JMS 2.0 规范中,该属性名已更改为目标查找,以便消息驱动的 Bean (MDB) 可以接收来自 JMS 队列或 JMS 主题的消息。
信息
必需
数据类型 字符串

连接工厂查找

连接工厂的 JNDI 名称。

输入消息驱动的 Bean 用来查找连接工厂属性以及在激活规范属性中覆盖这些属性的连接工厂的 JNDI 名称。
注: 如果在激活规范中将连接工厂查找定义为 JNDI 名称,那么连接工厂属性将优先于激活规范配置中定义的属性。例如,设置为连接工厂 JNDI 的组成部分的客户机标识优先于激活规范配置属性中定义的客户机标识。
信息
必需
数据类型 字符串

消息选择器

例如:
JMSType='car' AND color='blue' AND weight>2500

选择器字符串可引用 JMS 消息头中的字段和消息属性中的字段。消息选择器不能引用消息主体值。

Null 值(空字符串)表明没有消息选择器用于消息使用者。

信息
必需
数据类型 字符串

总线名

输入要连接的服务集成总线的名称。这必须是定义 目标查找 属性所标识的目标的总线的名称。
信息
必需
数据类型 定制

确认方式

确认方式表明应该如何确认消息驱动的 Bean 接收的消息。
注:

删除消息时发送确认。

如果您有非事务性消息驱动的 Bean,那么系统会在 Bean 启动或完成时删除消息。如果 Bean 生成异常,因而无法完成时,系统会采取以下某项操作:
  • 如果系统配置为在 Bean 完成时删除消息,那么会将消息派遣到 Bean 的新实例,从而使消息有进行处理的其他机会。
  • 如果系统配置为在 Bean 启动时删除消息,那么该消息会丢失。

如果服务质量设置为最大努力非持久,那么在 Bean 启动时删除消息。对于所有其他服务质量,在 Bean 完成时删除消息。

信息
必需
数据类型 下拉列表
范围
自动确认
会话自动确认消息的传递。

复制成功自动确认
会话迟延确认消息的传递,这可以提高性能,但会导致消息驱动的 Bean 多次接收消息。

目标

信息
必需
数据类型 字符串

目标类型

信息
必需
数据类型 下拉列表
范围
总线成员名称
总线成员的名称。此选项检索由指定的总线成员(应用程序服务器或服务器集群)主管的活动消息传递引擎。

定制消息传递引擎组名
一组构成自声明集群的定制消息传递引擎的名称。此选项检索已向所指定定制组注册的活动消息传递引擎。

消息传递引擎名称
消息传递引擎的名称。此选项检索可用于到达所指定消息传递引擎的可用端点。

目标重要性

信息
必需
数据类型 下拉列表
范围
首选
最好从目标组中选择消息传递引擎。如果目标组包含可用的消息传递引擎,那么将选择该消息传递引擎。如果目标组未包含可用的消息传递引擎,但在同一服务集成总线中有可用的消息传递引擎,那么将选择目标组外部的消息传递引擎。

必需
必须从目标组中选择消息传递引擎。如果目标组包含可用的消息传递引擎,那么将选择该消息传递引擎。如果目标组未包含可用的消息传递引擎,那么连接过程将失败。

目标入站传输链

如果所选消息传递引擎与应用程序在同一服务器中,那么将建立直接进程内连接并忽略此传输链属性。

传输链表示在服务器中工作的网络协议堆栈。您指定的名称必须是主管消息传递引擎的服务器中可用的传输链之一,就像服务器 -> 服务器类型 -> WebSphere 应用程序服务器 -> server_name -> [服务器消息传递] 消息传递引擎入站传输面板上列示的那样。系统提供了下列传输链,但您可以在此面板上定义自己的传输链。
InboundBasicMessaging
这是使用标准 TCP/IP 连接 (JFAP-TCP/IP) 的面向连接的协议。此协议支持两阶段事务(远程 XA)流,因此在客户机或服务器系统上运行的消息生产者或使用者可以参与此客户机或服务器系统上管理的全局事务。XA 流的具体用途是,支持从一个服务器上运行的应用程序访问第二个服务器上的消息传递引擎,进行此访问的原因可能是第一个服务器没有合适的消息传递引擎。如果使用远程 XA 流,那么在该应用程序的本地位置必须要有可用的事务协调程序。
InboundSecureMessaging
这是合并在 SSL 中的 InboundBasicMessaging 协议。
有关将此属性与连接工作负载管理的其他连接工厂属性配合使用的更多信息,请参阅“与总线的 JMS 连接的管理属性”主题。
信息
必需
数据类型 字符串

提供程序端点

用于连接至引导服务器的端点三元组(语法为“主机名:端口号:链名”)的列表,以逗号分隔各个端点三元组。例如,Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging。

除非在本地单元中找不到指定总线,否则不会使用提供程序端点。消息驱动的 Bean (MDB) 应用程序会先尝试连接至本地单元中的指定总线。如果此尝试失败,那么提供程序端点用于允许应用程序使用来自远程单元的消息。

如果未指定主机名,那么 localhost 将用作缺省值。

如果未指定端口号,那么 7276 用作缺省值。

如果未指定协议,那么预定义链(如 BootstrapBasicMessaging)用作缺省值。

信息
必需
数据类型 文本区域

最大批处理大小

单个批次中连续传递给单个消息驱动的 Bean 实例的最大消息数。与设置为复制成功自动确认确认方式配合使用时,消息批处理尤其能够提高性能。如果必须在失败传递之间保留消息顺序,请将批次大小设置为 1
信息
必需
数据类型 整数
范围 1 到 2147483647

每个端点的最大并发 MDB 调用数

增加此数字可提高性能,但是可增加任一时刻使用的线程数。如果必须在失败传送间保留消息排序,那么应将最大并行端点数设置为 1。仅当在其中使用消息驱动的 Bean 的目标并非分区目标时,消息排序才适用。分区目标用于集群中的工作负载分担场景。
信息
必需
数据类型 整数
范围 1 到 2147483647

在重复的消息失败时自动停止端点

这些参数使端点能够在连续失败消息数目达到指定限制时自动停止。这可帮助区分是消息自身问题(一个或两个消息失败)还是系统资源问题(导致多个连续失败消息)。

问题并非由未能处理的消息导致时,停止端点可以减少不必要地移至异常目标的消息的数目。

端点自动停止时,它在管理控制台面板上的状态显示为红色。必须通过单击恢复手动重新启动该端点。

在端点重新启动之后,就会重试导致端点停止的所有失败消息。如果消息仍然失败,那么会将他们移至异常目标(如果已配置该目标)。

启用

信息
必需
数据类型 布尔值

连续失败消息阈值

除非启用 在重复的消息失败时自动停止端点 属性,否则不会启用此属性。

信息
必需
数据类型 整数

失败消息重试之间的延迟

设置失败消息重试之间的延迟可减少 MDB 停止前不必要地移至异常目标的消息的数目。为尽量减少移动的消息的数目,应将此延迟设置为高于消息达到目标之间的期望时间间隔的值。

除非启用 在重复的消息失败时自动停止端点 属性,否则不会启用此属性。

信息
必需
数据类型 整数
范围 时间以毫秒计。值 0 指示重试之间没有延迟。

预订持久性

通常,同一时刻仅一个应用程序可以有特定持久预订的使用者。该属性可以使您重设该行为,以启用持久预订来拥有多个同时的使用者。
信息
必需
数据类型 下拉列表
范围
持久
当消息驱动的 Bean 不可用时,消息传递提供程序存储消息;当消息驱动的 Bean 再次可用时,消息传递提供程序传递消息。

非持久
当消息驱动的 Bean 不可用时,消息传递提供程序不存储和重新传递消息。

预订名称

每个 JMS 预订由预订名称(在此属性上指定)标识。JMS 连接还具有一个关联的客户机标识(在客户机标识属性上指定),用来将连接及其对象与 JMS 提供程序为客户机维护的预订的消息列表相关联。

此预订名称在给定的客户机标识中必须唯一。

信息
必需
数据类型 字符串

客户机标识

指定的值是客户机(消息驱动的 Bean)的唯一标识。客户机标识用于将客户机连接与消息传递提供程序为客户机保留的消息(在预订中)列表相关联。当客户机在不可用后再次可用时,消息传递提供程序使用客户机标识重新传递为正确客户机存储的消息。
信息
必需
数据类型 字符串

预订 Home

管理员可通过此消息传递引擎的发布点管理预订的运行时状态。
注: 对于共享非持续预订,预订 Home 字段下的消息传递引擎名称值将被视作目标消息传递引擎。因此,将忽略目标字段下定义的任何消息传递引擎名称。
信息
必需
数据类型 字符串

通过引用传递消息有效内容

发送大型对象消息或字节消息时,序列化、反序列化和复制消息有效内容的内存和处理器使用成本可能会很高。如果对连接工厂或激活规范启用通过引用传递消息有效内容属性,请通知缺省消息传递提供程序覆盖 JMS 1.1 规范并可能要减少或绕过此数据复制。
警告:
将定义这些属性所绕过的 JMS 规范的一部分,以确保消息数据完整性。 使用这些属性的所有 JMS 应用程序必须严格遵循“通过引用传递消息有效内容的原因及时间”主题中描述的规则,否则会有丢失数据完整性的风险。

使用此激活规范接收消息的应用程序必须遵循以下规则:

  • 该应用程序未修改从 JMS 对象消息获取的数据对象。该数据对象被视为只读对象。

信息
必需
数据类型 布尔值

使用此激活规范重新发送最初接收的消息的应用程序必须遵循以下规则:

  • 应用程序可替换 JMS 对象消息中的数据对象,前提是尚未在消息中设置该数据对象。在消息中设置数据对象后,应用程序不会修改或替换该数据对象。
  • 应用程序只会通过使用对 writeBytes(byte[]) 的单次调用来替换 JMS 字节消息中的字节数组,前提是尚未在消息中设置字节数组。在消息中设置字节数组后,应用程序不会修改或替换该字节数组。

信息
必需
数据类型 布尔值

共享持久预订

通常,同一时刻只能有一个会话具有特定持久预订的主题订户。此属性允许您重设此行为,以使持久预订能够同时有多个使用者,服务器集群中每个应用程序服务器上具有一个。
信息
必需
数据类型 下拉列表
范围
在集群中
允许从服务器集群内建立连接时共享持久预订。

总是共享
可以在各连接之间共享持久预订。

从不共享
从不在各连接之间共享持久预订。

与 CMP 共享数据源

此选项用作任务的一部分,以使容器管理的持久性 (CMP) 实体 Bean 能够共享消息传递引擎的数据存储器所使用的数据库连接。估计此选项可能会将整体消息吞吐量的性能提高 15%,但只能用于连接到消息传递引擎所在应用程序服务器的实体 Bean。 不得对使用文件存储库作为其数据存储的消息传递引擎启用此选项。

有关使用此选项的更多信息,请参阅“启用 CMP 实体 bean 和消息传递引擎数据存储器以共享数据库连接”主题。

信息
必需
数据类型 布尔值

提前读取

指定给使用者的消息被锁定在服务器上,并且不能被此目标的任何其他使用者使用。指定给使用者但在该使用者关闭前未被使用的消息随后在服务器上被解锁,这样其他使用者就可以接收那些消息。

通过对 JMS 目标设置提前读取属性,可以对各个 JMS 目标覆盖此属性。

信息
必需
数据类型 下拉列表
范围
缺省值
消息传递提供程序抢先将消息指定给非持久预订和非共享持久预订的使用者。即,仅当只存在一个使用者时才启用提前读取优化功能。

已启用
消息传递提供程序抢先将消息指定给使用者。此优化措施能够缩短满足使用者请求所耗用的时间。

已禁用
消息传递提供程序不会抢先将消息指定给使用者。

始终激活所有服务器中的 MDB

仅当 MDB 应用程序在属于应用程序的目标总线的服务器上运行时,才使用此属性。MDB 在不属于目标总线的服务器上运行时,此属性不起作用。

如果 MDB 在属于目标总线的服务器上运行,那么启用此选项允许 MDB 应用程序处理消息,不管该服务器是否同时主管正在运行的消息传递引擎都是如此。如果未启用此选项,那么在未运行本地 ME 的服务器上的 MDB 应用程序不会处理消息。

对于连接至集群总线成员的 MDB 应用程序,还可使用此选项启用下列任一其他配置:
  • 集群中的所有服务器可从 MDB 应用程序接收消息以充分利用集群中的处理能力。
  • 一次只有一个服务器能从 MDB 应用程序接收消息以确保顺序处理消息。
要允许集群中的所有服务器从 MDB 应用程序接收消息,请选择此选项。为了一次仅允许一个服务器从 MDB 应用程序接收消息,请检查此选项是否未被选中并在目标上选择独占接收选项。

有关更多信息,请参阅“集群中的消息驱动的 Bean 的连接方式”主题。

信息
必需
数据类型 布尔值

重试时间间隔

信息
必需
数据类型 整数
范围 1 到 2147483647

认证别名

Java Platform Enterprise Edition (Java EE) 连接器体系结构 (JCA) 认证别名指定用于对 JMS 提供程序认证新连接创建操作的用户标识和密码。

如果使用认证别名字段,那么不得指定用户名和密码定制属性。设置为应用程序部署的一部分的认证别名属性优先于对激活规范管理对象设置的属性。

仅当认证别名被写至采用未加密格式的文件中时(即使是为了事务恢复记录),才会使用安全服务来保护真正的用户名和密码。

在应用程序启动期间,当激活规范作为端点激活的一部分初始化时,服务器使用认证别名来从安全性检索真正的用户名和密码,然后在激活规范实例上设置该用户名和密码。

信息
必需
数据类型 下拉列表

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



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