消息侦听器服务定制属性

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

此属性控制当应用程序服务器连接至 IBM MQ for z/OS 时的侦听器端口行为。

添加属性后重新启动服务器。

如果要通过绑定连接连接至 IBM MQ for z/OS，那么也需要应用 IBM MQ V6.0.2.4 中提供的 IBM MQ APAR PK53912。

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

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

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

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

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

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

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

在 z/OS 系统上，无法选择非 ASF 方式，所以在此情况下不得为此属性设置非零值。

如果消息传递系统在非 ASF 方式中运行，要避免不需要的事务超时，那么必须设置足够的时间，以便在达到事务生存期超时总计之前可以完成处理。因此，必须确保为 NON.ASF.RECEIVE.TIMEOUT 消息侦听器服务定制属性指定的值小于为事务生存期超时总计事务服务属性指定的值，并且这两个属性值的差大于消息驱动 Bean (MDB) 的 onMessage() 方法处理消息所花费的时间。

例如，如果消息驱动的 Bean 的 onMessage() 方法通常最多花 10 秒，且事务超时设置为 120 秒，那么您可以将 NON.ASF.RECEIVE.TIMEOUT 属性设置为不超过 110000 毫秒（即 110 秒）。

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

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

当该属性设置为 false（缺省值）时，在将消息传递到消息驱动的 Bean 时，将自动确认消息。

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

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

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

如果您的消息传递系统在非 ASF 方式下运行，那么 SERVER.SESSION.POOL.REAP.TIME 定制属性不适用。

缺省服务器会话池超时（以秒计）。

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

如果您的消息传递系统在非 ASF 方式下运行，那么 SERVER.SESSION.POOL.UNUSED.TIMEOUT 定制属性不适用。

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

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

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

如果您的消息传递系统在非 ASF 方式下运行，那么 SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname 定制属性不适用。