消息侦听器服务定制属性
使用此面板查看或更改消息侦听器服务的定制属性。
要查看此管理控制台页面,请单击 。
- DYNAMIC.CONFIGURATION.ENABLED
ENABLE.ZOS.LP.RECOVERY
- MAX.RECOVERY.RETRIES
- MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
- MQJMS.POOLING.THRESHOLD
- MQJMS.POOLING.TIMEOUT
- NON.ASF.RECEIVE.TIMEOUT
- NON.ASF.BMT.ROLLBACK.ENABLED
- RECOVERY.RETRY.INTERVAL
- SERVER.SESSION.POOL.REAP.TIME
- SERVER.SESSION.POOL.UNUSED.TIMEOUT
- SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
DYNAMIC.CONFIGURATION.ENABLED
此属性控制是否需要重新启动创建了侦听器端口的应用程序服务器。将此属性设置为 true 以启用动态配置。
信息 | 值 |
---|---|
数据类型 | 布尔值 |
缺省值 | False(未选中) |
![[z/OS]](../images/ngzos.gif)
ENABLE.ZOS.LP.RECOVERY
此属性控制当应用程序服务器连接至 WebSphere MQ for z/OS 时的侦听器端口行为。
- 如果应用程序服务器和 WebSphere MQ 之间的连接已丢失(例如,如果已停止队列管理器),那么侦听器端口会尝试恢复。如果没有启用此属性,那么在停止队列管理器之后,侦听器端口不会尝试恢复。
- 将为侦听器端口配置多个工作负载管理分类。如果没有启用此属性,那么在为侦听器端口配置多个工作负载管理分类时,消息仍保留在WebSphere MQ 队列上。
添加属性后重新启动服务器。
如果要通过绑定连接连接至 WebSphere MQ for z/OS,那么也需要应用 WebSphere MQ V6.0.2.4 中提供的 WebSphere MQ APAR PK53912。
信息 | 值 |
---|---|
数据类型 | 布尔值 |
缺省值 | True(已启用) |
MAX.RECOVERY.RETRIES
此服务管理的侦听器端口在放弃并停止前尝试从故障恢复的最大次数。停止后,相关的侦听器端口就会转入停止状态。重试之间的时间间隔由 RECOVERY.RETRY.INTERVAL 属性定义。
- 当侦听器端口尝试从 JMS 提供程序获取消息时发生了意外的错误。
- 应用程序服务器与 JMS 提供程序之间的连接已断开(这通常是由网络错误导致的)。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 重试数 |
缺省值 | 5 |
范围 | 0(不重试)到 2147483647 |
MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
这是一个调速指示符,它允许在达到消息阈值下限时继续处理控制器消息。如果为消息侦听器服务配置了定制属性 MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH,并将此定制属性 的值设置为“true”,那么会在内部将阈值下限设置为阈值上限(这是在外部设置的侦听器端口“最大会话数”属性)。
信息 | 值 |
---|---|
数据类型 | 字符串 |
缺省值 | True |
MQJMS.POOLING.THRESHOLD
池中未使用连接的最大数。
MQSimpleConnectionManager 根据最近使用基础分配连接,并根据最先前使用基础销毁连接。缺省情况下,如果池中存在 10 个以上未使用的连接,那么销毁一个连接。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 连接数 |
缺省值 | 10 |
MQJMS.POOLING.TIMEOUT
在此毫秒数后,将销毁池中一直未使用的连接
MQSimpleConnectionManager 根据最近使用基础分配连接,并根据最先前使用基础销毁连接。缺省情况下,如果连接有 5 分钟处于未使用状态,那么销毁它。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 毫秒 |
缺省值 | 5 分钟 |
NON.ASF.RECEIVE.TIMEOUT
以毫秒为单位的超时,用于由消息驱动的 Bean 侦听器会话以非 ASF 的操作方式来执行的同步消息接收。
- ASF 方式对应用程序提供并行和事务支持。 对于发布/预订消息驱动的 Bean,ASF 方式可提供较好的吞吐量和并行性,因为侦听器在使用非 ASF 方式时是单线程的。
- 非 ASF 方式主要与不支持 JMS ASF 的第三方消息传递提供程序一起使用,它是对 JMS 规范的可选扩展。非 ASF 方式也是事务性的,但是由于路径长度小于 ASF 方式的路径长度,因此通常可提供较好的性能。
要在应用程序服务器上为所有消息驱动的 Bean 侦听器启用非 ASF 操作方式,请将此属性设置为非零值。
在 z/OS 系统上,无法选择非 ASF 方式,所以在此情况下不得为此属性设置非零值。
如果消息传递系统在非 ASF 方式中运行,要避免不需要的事务超时,那么必须设置足够的时间,以便在达到事务生存期超时总计之前可以完成处理。因此,必须确保为 NON.ASF.RECEIVE.TIMEOUT 消息侦听器服务定制属性指定的值小于为事务生存期超时总计事务服务属性指定的值,并且这两个属性值的差大于消息驱动 bean (MDB) 的 onMessage() 方法处理消息所花费的时间。
例如,如果消息驱动的 Bean 的 onMessage() 方法通常最多花 10 秒,且事务超时设置为 120 秒,那么您可以将 NON.ASF.RECEIVE.TIMEOUT 属性设置为不超过 110000 毫秒(即 110 秒)。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 毫秒 |
缺省值 | ASF 方式(定制属性未创建) |
范围 | 0 或大于 0 毫秒
|
NON.ASF.BMT.ROLLBACK.ENABLED
当使用非应用程序服务器设施(非 ASF)操作方式(因为您已将 NON.ASF.RECEIVE.TIMEOUT 属性设置为非零值),并且使用 Bean 管理的事务的消息驱动 Bean 生成运行时异常时,NON.ASF.BMT.ROLLBACK.ENABLED 属性决定是否将消息返回到目标。
- ASF 方式对应用程序提供并行和事务支持。 对于发布/预订消息驱动的 Bean,ASF 方式可提供较好的吞吐量和并行性,因为侦听器在使用非 ASF 方式时是单线程的。
- 非 ASF 方式主要与不支持 JMS ASF 的第三方消息传递提供程序一起使用,它是对 JMS 规范的可选扩展。非 ASF 方式也是事务性的,但是由于路径长度小于 ASF 方式的路径长度,因此通常可提供较好的性能。
在 z/OS 系统上,无法选择非 ASF 方式。
当该属性设置为 false(缺省值)时,在将消息传递到消息驱动的 Bean 时,将自动确认消息。
当该属性设置为 true 时,消息侦听器服务在消息驱动的 Bean 成功处理消息后会将消息确认发送给客户机,并且消息侦听器服务请求恢复该 Bean 生成了异常的任何消息。
信息 | 值 |
---|---|
数据类型 | 布尔值 |
缺省值 | False |
RECOVERY.RETRY.INTERVAL
侦听器端口在两次尝试从故障恢复之间的秒数。最大尝试次数是由 MAX.RECOVERY.RETRIES 属性定义的。
- 当侦听器端口尝试从 JMS 提供程序获取消息时发生了意外的错误。
- 应用程序服务器与 JMS 提供程序之间的连接已断开(这通常是由网络错误导致的)。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 秒 |
缺省值 | 60 |
范围 | 1 到 2147483647 |
SERVER.SESSION.POOL.REAP.TIME
在服务器会话池上进行检查的间隔时间(以秒为单位)。要启用服务器会话池监控,请将该属性设置为非负值。
如果您的消息传递系统在非 ASF 方式下运行,那么 SERVER.SESSION.POOL.REAP.TIME 定制属性不适用。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 秒 |
缺省值 | -1(已禁用) |
范围 | -2147483648 到 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT
缺省服务器会话池超时(以秒计)。
此属性设置为非负值时,会将使用服务器会话以来耗用的时间与该值进行比较。如果超时值小于耗用时间,那么将从服务器会话池中移除该服务器会话并将其 JMS 会话返回到 JMS 会话池中。例如,如果超时值是一秒,而某个特定服务器会话在上次被使用后的耗用时间是两秒,那么将从服务器会话池中移除该服务器会话并使其 JMS 会话返回到 JMS 会话池中。
如果您的消息传递系统在非 ASF 方式下运行,那么 SERVER.SESSION.POOL.UNUSED.TIMEOUT 定制属性不适用。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 秒 |
缺省值 | -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。
如果此覆盖设置为负值,那么它会禁用指定侦听器端口的服务器会话池监控。
如果您的消息传递系统在非 ASF 方式下运行,那么 SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname 定制属性不适用。
信息 | 值 |
---|---|
数据类型 | Integer |
单位 | 秒 |
缺省值 | 未设置 |
范围 | -2147483648 到 2147483647 |