服务集成定制属性

使用定制属性配置消息传递引擎之类的服务集成对象的高级设置。

sib.msgstore.cachedDataBufferSize

消息传递引擎用于包含数据的数据缓冲区的大小(以字节计),此数据的服务质量属性优于最大努力非持久,并且存放在数据存储器中。缺省值为 320000,即大约 320 千字节。

高速缓存数据缓冲区的用途是通过将消息传递引擎本来必须从数据存储器中读取的数据高速缓存在内存中来提高消息传递引擎的性能。当它将数据写至数据存储器以及从数据存储器中读取数据时,消息传递引擎会尝试将该数据添加到高速缓存数据缓冲区。消息传递引擎可能会废弃缓冲区中已包含的数据以便腾出空间。

数据类型 缺省值
字节 40000000

sib.msgstore.discardableDataBufferSize

消息传递引擎用于包含数据的数据缓冲区的大小(以字节计),此数据的服务质量属性为“最大努力非持久”。缺省值为 320000,即大约 320 千字节。

可废弃数据缓冲区包含所有具有服务质量属性“最大努力非持久”的数据。该数据既包括有关活动事务的数据,也包括消息传递引擎既未废弃也未使用的任何其他最大努力非持久数据。消息传递引擎将此数据完全存放在此内存缓冲区中,并且从不将此数据写至数据存储器。消息传递引擎将数据添加到可废弃的数据缓冲区时,例如,当消息传递引擎从客户机接收到最大努力非持久消息时,消息传递引擎可能会废弃缓冲区中已包含的数据以便腾出空间。消息传递引擎只能废弃与活动事务无关的数据。此行为使消息传递引擎能够废弃最大努力非持久消息。

增加可废弃数据缓冲区的大小允许在消息传递引擎开始废弃消息之前处理更多最大努力非持久数据。

如果在废弃活动事务未涉及的所有数据之后仍然没有足够的空间,那么当消息传递引擎尝试将数据添加到可废弃数据缓冲区时,消息传递引擎将抛出 com.ibm.ws.sib.msgstore.OutOfCacheSpace 异常。客户机应用程序可以捕获此异常,此异常合并在特定于 API 的异常(如 javax.jms.JMSException)中。

数据类型 缺省值
字节 1280000

sib.msgstore.jdbcFailoverOnDBConnectionLoss

此属性确定在断开与数据存储器的连接时消息传递引擎及其主管服务器的行为。

属性值 断开数据存储器连接时的行为
true(缺省值)
当下一次检查核心组服务是否处于工作状态时(缺省值是每 120 秒检查一次),高可用性管理器将停止消息传递引擎及其主管应用程序服务器。如果 Node Agent 正在监视服务器并且您在服务器的监视策略中启用了自动重新启动,那么服务器将重新启动。消息传递引擎将在相关服务器可用时启动。
注: 在进行是否处于工作状态检查的时间间隔期间,消息传递引擎可能会接受可靠性级别低于有保证的持久的消息,并可能丢失这些消息。
false

消息传递引擎继续运行并接受工作,并且会定期尝试重新建立与数据存储器的连接。如果在数据存储器不可用时继续将工作提交给消息传递引擎,那么结果将是不可预测的,并且当恢复数据存储器连接时,消息传递引擎会处于不一致状态。

注: 如果继续将工作提交给消息传递引擎,那么甚至非持久消息传递也会失败,这是因为消息传递引擎可能需要使用数据存储器,例如,使用数据存储器将唯一标识分配给消息或将非持久消息移出内存。

sib.msgstore.jdbcInitialDatasourceWaitTimeout

等待数据存储器变为可用的时间(以毫秒计)此时间包括建立与数据库的连接所需的时间以及获得所需的表锁定所需的时间。

数据类型 缺省值
毫秒 900000(15 分钟)

sib.msgstore.jdbcResAuthForConnections

共享连接时使用的消息传递引擎资源授权机制。缺省值是“容器”。

数据类型 缺省值
字符串 容器

sib.msgstore.jdbcStaleConnectionRetryDelay

连接至数据存储器的尝试之间要等待的时间(以毫秒计)。

例如,如果将 sib.msgstore.jdbcInitialDatasourceWaitTimeout 属性设置为 600000,并将 sib.msgstore.jdbcStaleConnectionRetryDelay 属性设置为 3000,那么消息传递引擎将每隔 10 分钟零 3 秒尝试连接一次。

信息
数据类型 毫秒
缺省值 2000(2 秒)

sib.meEnableInstanceOnFailure

该属性确定在消息传递引擎与数据存储器失去连接时,是否必须自动再次启用已禁用的消息传递引擎。

例如,如果将 sib.meEnableInstanceOnFailure 属性值设置为 true,那么已禁用的消息传递引擎将在 30 秒后尝试启用自身。

信息
数据类型 布尔值
缺省值 True

sib.processor.maxReconstituteThreadpoolSize

指定当启动消息传递引擎时,用于同时装入目标的线程数。如果数据库不支持多个线程并行执行多个读取操作,那么您可以将属性值设置为 1,以便可避免线程之间发生争用。

信息
数据类型 整数
缺省值 系统中存在的核心数。

sib.msgstore.storeFullWaitForCheckPoint

此属性确定在文件存储器已满且应用程序尝试发送更多消息时消息传递引擎所执行的操作。

当文件存储器已满时,消息传递引擎将检查日志文件,以协调自上一次检查以来的所有消息发送和接收。此过程可能要花一些时间来完成。在文件存储器变满与检查完成所间隔的时间内,如果应用程序尝试发送消息,那么消息传递引擎将抛出异常 ObjectStoreFullException 并发出消息 CWSOM1042E。

发送消息的应用程序线程发现文件库变满时,它会请求检查点。属性值设置为 false 时的缺省行为是,应用程序线程立即向应用程序抛出异常 ObjectStoreFullException 并返回。您可以通过将属性值设置为 true 来选择另一种行为。设置为此属性值时,应用程序线程将不抛出异常,而是等到检查完成为止。如果检查释放文件存储器中的空间,那么应用程序线程将继续并发送消息,然后再返回。如果在完成检查后文件存储器仍处于已满状态,那么应用程序线程将向应用程序抛出异常。

如果应用程序删除文件存储器中的所有消息,并因此从逻辑上说它们知道文件存储器不再处于已满状态,请将属性值设置为 true 并使应用程序线程等到检查完成。虽然应用程序仍必须等到检查完成,但它们在检查执行期间不会接收到异常,因此不必重试发送。

信息
数据类型 布尔值
缺省值 False

sib.msgstore.transactionSendLimit

消息传递引擎在每个事务中包括的最大操作数。例如,每一项 JMS 发送或接收操作都会使计数更加接近于事务发送限制。缺省值为 100

数据类型 缺省值
整数 100
[z/OS]

sib.ra.zosMessageLockTimeout

在将消息提交给 z/OS® 工作负载管理 (WLM) 以传送到消息驱动的 Bean 之后,在消息传递引擎中锁定该消息的秒数。

WLM 将该消息分配到服务方区域,该服务方区域将创建与消息传递引擎的连接。然后,服务方区域使用该消息并将其传递到消息驱动的 Bean 的 onMessage 方法。

如果服务方区域未能连接至消息传递引擎并且未能在将其传递到消息驱动的 Bean 之前使用该消息,那么该消息将继续处于锁定状态,直到达到该超时值为止。达到该超时后,将解锁该消息并重试传送。

在启动应用程序服务器期间,在连接至消息传递引擎所需的基础结构可用之前,如果 WLM 将消息传送到服务方区域,那么该服务方区域可能无法连接至消息传递引擎。此类型的连接故障由服务方区域的作业日志中的 CWSIV1052W 条目指示。如果您在作业日志中看到这样的条目,并且您已锁定消息,请考虑使用此属性来使“消息锁定超时”更短。

数据类型 缺省值
300

sib.trm.retry

消息传递引擎之间的连接重试时间间隔(以秒计)。重试时间间隔是与存在通信的相邻消息传递引擎进行联系的尝试之间的时间延迟。缺省重试时间间隔是 30 秒。

数据类型 缺省值
30

sib.wsrm.tokenLockTimeout

此属性影响 WS-ReliableMessaging 所管理的服务质量。请在 WS-ReliableMessaging 应用程序的策略绑定所指定的消息传递引擎上设置此属性。

此属性是锁定 WS-ReliableMessaging 消息的时间量(以毫秒计)。如果在处理消息时服务器出现故障,那么将在此超时时间段结束时释放锁定,以便其他服务器可以继续处理。如果原始服务器在超时时间段结束之前恢复,那么它将继续处理消息。即使仍在处理消息,也会在超时时间段结束时释放锁定。

如果系统正在处理大型消息,那么您可能想要增大此属性的值。例如,如果处理消息需要 12 分钟,那么锁定将在处理完成前的 2 分钟释放。为了避免这种情况,请将该属性更改为大于 12 分钟的值。

如果系统正在处理小型消息,那么您可能想要减小此属性的值,以便在发生故障时更快地释放锁定,并使其他服务器能够继续处理而不会出现任何延迟。

[z/OS]注:

如果在处理消息期间服务方区域异常结束,那么控制区域将启动一个新的服务方区域,此服务方区域必须等到消息锁定释放后,才能继续处理该消息。如果服务方区域太长时间处于不活动状态,那么控制区域会将其结束并启动另一个服务方区域。另外,如果服务方区域耗用很长时间处理消息,那么控制区域可能会认为服务方区域处于不活动状态并将其结束。

在被控制区域结束之前服务方区域可以保持处于不活动状态的时间量受各种超时(例如 control_region_wlm_dispatch_timeout 属性)影响。请检查系统配置以确定适合于该系统的这个时间段。

为了避免在消息处理完之前控制区域结束服务方区域,请将令牌锁定超时属性的值设置为小于服务方区域可以处于不活动状态的时间量。

信息
数据类型 毫秒
缺省值 600000(10 分钟)

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



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