消息侦听器服务定制属性

使用此面板查看或更改消息侦听器服务的定制属性。

要查看此管理控制台页面,请单击服务器 > 服务器类型 > WebSphere Application Server > server_name > [通信] 消息传递 > 消息侦听器服务 > 定制属性

您可以使用定制属性页面来定义以下由消息侦听器服务使用的属性。
DYNAMIC.CONFIGURATION.ENABLED

此属性控制是否需要重新启动创建了侦听器端口的应用程序服务器。将此属性设置为 true 以启用动态配置。

数据类型 布尔值
缺省值 False(未选中)
MAX.RECOVERY.RETRIES

此服务管理的侦听器端口在放弃并停止前尝试从故障恢复的最大次数。停止后,相关的侦听器端口就会转入停止状态。重试之间的时间间隔由 RECOVERY.RETRY.INTERVAL 属性定义。

以下任一情况都可能导致故障:
  • 当侦听器端口尝试从 JMS 提供程序获取消息时发生了意外的错误。
  • 应用程序服务器与 JMS 提供程序之间的连接已断开(这通常是由网络错误导致的)。
数据类型 整型
单位 重试数
缺省值 5
范围 0(不重试)到 2147483647
MQJMS.POOLING.THRESHOLD

池中未使用连接的最大数。

MQSimpleConnectionManager 根据最近使用基础分配连接,并根据最先前使用基础销毁连接。缺省情况下,如果池中存在 10 个以上未使用的连接,那么销毁一个连接。

数据类型 整型
单位 连接数
缺省值 10
MQJMS.POOLING.TIMEOUT

在此毫秒数后,将销毁池中一直未使用的连接

MQSimpleConnectionManager 根据最近使用基础分配连接,并根据最先前使用基础销毁连接。缺省情况下,如果连接有 5 分钟处于未使用状态,那么销毁它。

数据类型 整型
单位 毫秒
缺省值 5 分钟
NON.ASF.RECEIVE.TIMEOUT

以毫秒为单位的超时,用于由消息驱动的 bean 侦听器会话以非 ASF 的操作方式来执行的同步消息接收。

注: 消息侦听器服务有两种操作方式,应用程序服务器设施(ASF)和非应用程序服务器设施(非 ASF):
  • ASF 方式对应用程序提供并行和事务支持。 对于发布/预订消息驱动的 bean,ASF 方式可提供较好的吞吐量和并行性,因为侦听器在使用非 ASF 方式时是单线程的。
  • 非 ASF 方式主要与不支持 JMS ASF 的第三方消息传递提供程序一起使用,它是对 JMS 规范的可选扩展。非 ASF 方式也是事务性的,但是由于路径长度小于 ASF 方式的路径长度,因此通常可提供较好的性能。

要在应用程序服务器上为所有消息驱动的 bean 侦听器启用非 ASF 操作方式,请将此属性设置为非零值。

[z/OS] 在 z/OS 系统上无法选择非 ASF 方式,因此您不应对此属性设置非零值。

数据类型 整型
单位 毫秒
缺省值 ASF 方式(定制属性未创建)
范围 0 或大于 0 毫秒
0
禁用非 ASF 方式
1 或更多
以毫秒为单位的超时,用于非 ASF 消息驱动的 bean 侦听器同步会话接收
建议 如果发生事务超时,那么消息必须回收引起的额外工作。如果您希望使用非 ASF 方式,请将该属性设置为低于事务超时,但大于或等于消息驱动的 bean 的 onMessage() 方法的最大持续时间。例如,如果消息驱动的 bean 的 onMessage() 方法通常最多花 10 秒,且事务超时设置为 120 秒,那么您可以将 NON.ASF.RECEIVE.TIMEOUT 属性设置为不超过 110000 毫秒(即 110 秒)。
NON.ASF.BMT.ROLLBACK.ENABLED

当使用非应用程序服务器设施(非 ASF)操作方式(因为您已将 NON.ASF.RECEIVE.TIMEOUT 属性设置为非零值),并且使用 bean 管理的事务的消息驱动 bean 生成运行时异常时,NON.ASF.BMT.ROLLBACK.ENABLED 属性决定是否将消息返回到目标。

注: 消息侦听器服务有两种操作方式,应用程序服务器设施(ASF)和非应用程序服务器设施(非 ASF):
  • ASF 方式对应用程序提供并行和事务支持。 对于发布/预订消息驱动的 bean,ASF 方式可提供较好的吞吐量和并行性,因为侦听器在使用非 ASF 方式时是单线程的。
  • 非 ASF 方式主要与不支持 JMS ASF 的第三方消息传递提供程序一起使用,它是对 JMS 规范的可选扩展。非 ASF 方式也是事务性的,但是由于路径长度小于 ASF 方式的路径长度,因此通常可提供较好的性能。

[z/OS] 在 z/OS 系统上无法选择非 ASF 方式。

当该属性设置为 false(缺省值)时,在将消息传递到消息驱动的 bean 时,将自动确认消息。

当该属性设置为 true 时,消息侦听器服务在消息驱动的 bean 成功处理消息后会将消息确认发送给客户机,并且消息侦听器服务请求恢复该 bean 生成了异常的任何消息。

数据类型 布尔值
缺省值 False
RECOVERY.RETRY.INTERVAL

侦听器端口在两次尝试从故障恢复之间的秒数。最大尝试次数是由 MAX.RECOVERY.RETRIES 属性定义的。

以下任一情况都可能导致故障:
  • 当侦听器端口尝试从 JMS 提供程序获取消息时发生了意外的错误。
  • 应用程序服务器与 JMS 提供程序之间的连接已断开(这通常是由网络错误导致的)。
数据类型 整型
单位
缺省值 60
范围 1 到 2147483647
SERVER.SESSION.POOL.REAP.TIME

在服务器会话池上进行检查的间隔时间(以秒为单位)。要启用服务器会话池监控,请将该属性设置为非负值。

数据类型 整型
单位
缺省值 -1(已禁用)
范围 -2147483648 到 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT

缺省服务器会话池超时(以秒计)。

此属性设置为非负值时,会将使用服务器会话以来耗用的时间与该值进行比较。如果超时值小于耗用时间,那么会将服务器会话从服务器会话池中除去,并且其 JMS 会话将返回到 JMS 会话池。例如,如果超时值是一秒,而使用某个特定的服务器会话后耗用的时间是两秒,那么会将服务器会话从服务器会话池中除去,并且其 JMS 会话将返回到 JMS 会话池。

数据类型 整型
单位
缺省值 -1(已禁用)
范围 -2147483648 到 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname

此属性覆盖名称定义为 lpname 的侦听器端口的缺省 SERVER.SESSION.POOL.UNUSED.TIMEOUT 值。 此值应用于使用指定的侦听器端口的所有消息驱动的 bean。

如果此覆盖设置为非负值,那么即使 SERVER.SESSION.POOL.UNUSED.TIMEOUT 属性的值为负值,它也会覆盖 SERVER.SESSION.POOL.UNUSED.TIMEOUT

如果此覆盖设置为负值,那么它会禁用指定侦听器端口的服务器会话池监控。

数据类型 整型
单位
缺省值 未设置
范围 -2147483648 到 2147483647



标有(在线)的链接要求访问因特网。

相关任务
相关参考


文件名: umb_prolscp.html