事务服务定制属性

WebSphere® Application Server 允许您配置事务服务的许多定制属性。

注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

可以在管理控制台中指定事务服务定制属性。要使用其中的任何定制属性,请单击服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name > [容器设置] 容器服务 > 事务服务 > [其他属性] 定制属性

避免故障 避免故障: 在 z/OS 中,请确保所有相关的日志流都已设置为 AUTODELETE(NO)。gotcha

DELAY_CANCELLING_ALARMS

如果在事务过程的完成前阶段很可能要包括需要很长时间才能完成或者可能失败的过程,那么您可能需要使该事务超时。

缺省情况下,将在事务的完成前阶段开始之前取消事务超时警报。DELAY_CANCELLING_ALARMS 定制属性允许将事务的完成前阶段包含在事务超时期间。为此,请在应用程序服务器上设置该定制属性。

表 1. DELAY_CANCELLING_ALARMS 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE
[z/OS]

DISABLE_DEFERRED_CTX_REGISTRATION

缺省情况下,将延迟向 z/OS 本机事务上下文注册 WebSphere 全局事务,直到向全局事务登记资源为止。这种延迟注册是一种增强功能,设计用来提高在当前事务中未涉及 RRS 资源的场景(例如,只登记了 XA 资源时)的性能 - 当不需要后续注册时,此功能可避免进行与向本机上下文注册相关的额外处理。如果事务获得 RRS 资源,虽然仍会发生延迟注册,但是不会对性能有任何提高。

DISABLE_DEFERRED_CTX_REGISTRATION 定制属性将禁用向 z/OS 本机事务上下文延迟注册 WebSphere 全局事务的功能。禁用延迟注册时,将在创建 WebSphere 全局事务期间自动向本机事务上下文注册。

有些情况下,不期望延迟 RRS 资源的本机上下文注册。在以下情况下,请设置 DISABLE_DEFERRED_CTX_REGISTRATION=true
  • 应用程序将激活游标可持有性,该游标可持有性在特定的情况下允许结果集在跨越事务边界时保持打开。
表 2. DISABLE_DEFERRED_CTX_REGISTRATION 定制属性
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE
[z/OS]

DISABLE_OUTBOUND_CASCADED_SUPPORT

指定事务管理器是否要禁用允许启动层叠事务的支持以及是否能够让 z/OS 上其他也支持 RRS 层叠事务处理的 WebSphere Application Server 成为层叠系列的一部分。

如果您不需要出站层叠支持,那么将该值设置为 true。 将该值设置为 true 将会促使服务器回到缺省条件下并使用标准的 JTS 事务转播。

表 3. DISABLE_OUTBOUND_CASCADED_SUPPORT 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE

DISABLE_RECOVERY_AUDIT_LOGGING

您可以控制事务服务恢复期间参考消息是否显示在管理控制台中并写入 SystemOut.log 文件。为此,请为服务器的事务服务设置 DISABLE_RECOVERY_AUDIT_LOGGING 定制属性。

[AIX Solaris HP-UX Linux Windows][IBM i]在分布式平台上,缺省值是事务服务恢复期间参考消息将显示在管理控制台中并写入 SystemOut.log 文件。如果您不希望显示这些消息,那么可以使用 DISABLE_RECOVERY_AUDIT_LOGGING 定制属性。

[z/OS]在 z/OS® 上,缺省情况下,事务服务恢复期间参考消息不会显示在管理控制台中,也不会写入 SystemOut.log 文件。如果您希望显示这些消息,那么可以使用 DISABLE_RECOVERY_AUDIT_LOGGING 定制属性。

[z/OS]注: 在 z/OS 上,如果您选择打开事务恢复审计消息,那么其他审计消息(例如,与服务方恢复和 XA 资源恢复相关的审计消息)也会显示在控制台中并写入 SystemOut.log 文件。
表 4. DISABLE_RECOVERY_AUDIT_LOGGING 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省

[AIX Solaris HP-UX Linux Windows][IBM i]FALSE

[z/OS]TRUE

[z/OS]

DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD

指定事务超时与正在运行事务的服务方区域异常结束之间是否存在延迟。

如果将此值设置为 false,那么会将超时的全局事务标记为“仅回滚”。事务服务器提供大约四分钟的附加时间段来完成相关联的应用程序。如果应用程序在此时间内完成,那么将回滚事务。如果应用程序在此时间内未完成,那么应用程序和关联的服务方区域将异常结束,并且会发出 ABENDEC3 或 ABENDSEC3 错误。

将此值设置为 true 以消除延迟,并立即使应用程序和服务方区域异常结束。

表 5. DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE
[z/OS]

DISABLE_WSTX_RMFAIL_LOGGING

指定如果 WS-AT 参与者在异步响应超时时段内未能发送响应,同时导致发生 XAER_RMFAIL 事务异常,是否向错误日志文件发送 RMFAIL 消息。

如果将此值设置为 false,那么当 WS-AT 参与者在异步响应超时时段内未能发送响应时,将向错误日志文件发送 RMFAIL 消息。

如果当 WS-AT 参与者在异步响应超时时段内未能发送响应时,您不要向错误日志文件发送 RMFAIL 消息,请将此值设置为 true。

表 6. DISABLE_WSTX_RMFAIL_LOGGING 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE

ENABLE_XARESOURCE_TIMEOUT

如果将此属性的值设置为 true,那么当在全局事务中包含了 XA 资源时,事务服务将提供这些 XA 资源的超时值。所提供的超时将是该事务设置为超时之前剩余的秒数。

表 7. ENABLE_XARESOURCE_TIMEOUT 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 FALSE

REMOVE_PARTNER_LOG_ENTRY

可以从事务伙伴日志文件中移除条目。为此,请在拥有伙伴日志的服务器上设置事务服务的 REMOVE_PARTNER_LOG_ENTRY 定制属性。

在事务恢复过程中,将检查伙伴日志以确定所需的资源。如果要从伙伴日志中移除某些条目(例如,不再存在的资源),请在拥有事务伙伴日志(它包含要移除的条目)的应用程序服务器设置此定制属性。

仅当下列两种情况都存在时,REMOVE_PARTNER_LOG_ENTRY 定制属性才有效。

  • 以恢复方式启动了应用程序服务器。
  • 应用程序服务器没有任何当前需要恢复的事务。可以通过检查 SystemOut.log 文件来进行确定。
表 8. REMOVE_PARTNER_LOG_ENTRY 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 整数
可接受的值 (一个或多个以逗号分隔的整数恢复标识)
缺省 (null)
[z/OS]

RLS_LOGSTREAM_COMPRESS_INTERVAL

指定恢复日志服务尝试压缩日志流应用程序组件时要使用的时间间隔(以秒计)。可以将“事务服务”(XA 伙伴日志)和“补偿服务”组件配置为使用恢复日志服务。

在每个时间间隔内检查一次是否压缩了日志流。如果未使用日志流,那么此操作可能会导致不必要的 CPU 占用。

注:
  • 如果不将日志流用于补偿服务,那么将此属性的值设置为大于缺省值。
  • 如果恢复日志服务使用日志流,那么不要将此属性的值设置得太大。如果在压缩时间间隔到期之前恢复日志服务日志流已满,那么事务可能开始失败,直到压缩了日志流为止。
  • 如果没有组件被配置为使用日志流,那么将此属性设置为 0(零)以禁用此功能。
表 9. RLS_LOGSTREAM_COMPRESS_INTERVAL 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 整数
可接受的值 0 - 2,147,483,647(如果值为 0,那么将禁用此功能)
缺省 30 秒

ZOS_RECOVER_BEFORE_COMMIT

指定此属性可防止在恢复时对 MQ 服务器资源发出 xa_recover 调用之后发生死锁。MQ 服务器将 JCA 1.5 事务入流接口用作其常规操作的一部分。这些接口使 MQ 服务器总线成员能够使用 WebSphere Application Server 事务来协调 WMQ 和服务集成总线资源。在恢复时落实任何事务期间,将调用 xa_recover 以确保即使在发出 xa_commit 或 xa_rollback 调用时该事务存在,某些较旧的 DB2 驱动程序也不返回 XAER_NOTA。

此死锁发生的原因是因为 MQ 服务器资源对控制器发出回调并尝试锁定所有已知事务,以便 MQ 服务器资源可以生成需要对 xa_recover 调用做出响应的事务列表。但是,因为正在落实的 IN-COMMIT 事务已经锁定,所以 xa_recover 调用将无限期地等待锁定 IN-COMMIT 事务(这是因为该事务将不解锁,直到该事务落实为止)。

将此属性设置为 FALSE 可确保在恢复时处理事务期间,不会在 xa_commit 或 xa_rollback 调用之前发出 xa_recover 调用。

避免故障 避免故障: 所有目前受支持的 DB2 驱动程序都具有自动恢复功能,该功能使得不必在发出 xa_commit 或 xa_rollback 调用之前发出 xa_recover 调用。在阅读 DB2 驱动程序的文档之后,如果您不确定 DB2 驱动程序是否包括自动回复功能,请与 IBM DB2 支持机构联系以获取关于设置此属性是否安全以用于主管应用程序(用于访问 DB2)的服务器的最终说明。gotcha
表 10. ZOS_RECOVER_BEFORE_COMMIT 定制属性. 该表包含属性的数据类型、可接受的值和缺省值。
信息
数据类型 布尔值
可接受的值 TRUE 和 FALSE
缺省 TRUE

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



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