事务服务设置

为此服务器指定补偿服务用于存储恢复日志文件的目录名。 （可选）可以指定事务日志文件的大小。对于 z/OS® 平台，指定 JTA 伙伴日志的位置。

仅当应用程序使用分布式资源或 XA 事务（例如在单个事务中访问多个数据库和资源）时，才需要设置此属性以更改应用程序服务器的事务日志文件目录。

如果在服务器配置期间未指定此目录，那么事务服务将使用基于安装目录的缺省目录：app_server_root/ tranlog/cell_ name/node_ name/server_ name。

当在应用程序服务器上运行的应用程序访问多个资源时，应用程序服务器会将事务信息存储在产品目录中，以便能够正确地协调和管理分布式事务。当事务负载较高时，按这种方式存储持久信息会降低应用程序服务器的性能，因为性能取决于操作系统和底层的存储系统。为了提高性能，请对日志文件指定新的目录，此目录应该位于物理空间更大的独立存储系统上。

如果应用程序服务器出现下列其中一个或多个症状，请更改事务日志目录：

• 尽管事务增加，但是 CPU 利用率仍然很低
• 事务由于多次超时而失败
• 由于发生了“无法加入事务列表”异常，因此对事务进行了回滚
• 应用程序服务器在运行过程中停止，必须将它重新启动
• 正在运行应用程序服务器的磁盘表明使用率较高

对日志文件的存储系统提供下列建议：

• 将日志文件存储在独立磁盘冗余阵列 (RAID) 中

  在 RAID 配置中，将数据写入物理介质的任务是在多个驱动器之间共同执行的。此技术允许对保存事务信息的存储器进行并发度更高的访问，并且能够提高日志数据访问速度。根据应用程序和存储子系统的设计情况，性能提升幅度为 10% 到 100%，在某些情况下会更高。

• 不要在将操作系统 I/O 方式设置为并发 I/O (CIO) 的情况下存储日志文件

  在指定事务日志目录时，请确保文件系统仅使用同步直写和写串行化操作。某些操作系统（例如 AIX® JFS2）支持可选的并发 I/O (CIO) 方式，在此方式下，文件系统不会对写操作强制执行串行化。在这些系统中，不要对应用程序服务器事务恢复日志文件使用 CIO 方式。

要指定事务日志文件的大小，应包括文件大小设置。使用以下其中一种格式，其中　directory_name 是事务日志目录的名称，file_size 是为事务日志文件新分配的磁盘空间，按 KB (nK) 或 MB (nM) 指定。可以指定的最小事务日志文件大小为 64K。如果您指定的值小于 64K，或者没有为文件大小指定值，那么将使用缺省值 1M。

;file_size   <!-- This format keeps the default directory -->

directory_name;file_size

dir://directory_name/directory_name;file_size

/directory_name/directory_name;file_size

有关事务日志大小的更多信息，请参阅管理事务日志记录以获得服务器的最佳可用性。

信息	值
数据类型	字符串
缺省值	目录名：app_server_root/tranlog/cell_name/node_name/server_name 文件大小：1MB
建议	创建至少具有三到四个磁盘驱动器的文件系统，这些驱动器一起组合在 RAID-0 配置中。然后，在此文件系统上创建具有缺省大小的事务日志。当服务器在正常负载下运行时，检查磁盘输入和输出。如果磁盘输入和输出时间大于 5%，那么应考虑添加更多物理磁盘，以减小此值。

在 z/OS 上，此日志用于 XA 资源的恢复。当在 WebSphere 产品上运行的应用程序访问 XA 资源时，WebSphere 产品存储有关此资源的信息，以启用 XA 事务恢复。使用以下语法：

[location type URL tag] location_specification

• location type URL tag 指定 JTA 伙伴日志的可选位置类型：
  • 缺省值为 dir://，它指定 JTA 伙伴日志位置位于由 location_specification 指定的标准 HFS 目录中。
• location specification 指定 JTA 伙伴日志的位置名：
  • 要指定日志流，请使用语法 logstream://HLQ
    如果应用程序服务器安装遵循耦合工具 (CF) 的配置日志流的约定，那么日志流是根据语法 HLQ.server.X 命名的，其中 HLQ 是在安装对话框中所指定长度为 1-8 个字符的用户定义值。使用这个 HLQ 值来指定 JTA 伙伴日志位置。

    避免故障： 为任何日志流设置 AUTODELETE(NO)。gotcha
  • 如果 location type URL tag 是 dir://，那么 location specification 使用标准 HFS 目录。完整的目录名在 WebSphere 节点中必须是唯一的。

缺省值为 dir://app_server_root/tranlog/server name。

要指定事务日志文件的大小，应包括文件大小设置。使用以下其中一种格式，其中　directory_name 是事务日志目录的名称，file_size 是为事务日志文件新分配的磁盘空间，按 KB (nK) 或 MB (nM) 指定。可以指定的最小事务日志文件大小为 64K。如果您指定的值小于 64K，或者没有为文件大小指定值，那么将使用缺省值 1M。

dir://directory_name/directory_name;file_sizeK

/directory_name/directory_name;file_sizeK

;file_sizeK   <!-- This keeps the default directory -->

缺省最大时间长度（以秒计），在事务服务触发超时完成之前将允许此服务器上启动的事务使用的时间。会回滚在此超时发生之前不开始完成处理的任何事务。

仅当应用程序组件未设置自己的事务超时时，才使用此超时。

发生超时后，将允许事务继续运行大约 4 分钟的一段宽限期。如果事务在宽限期内落实或回滚，那么事务结果将总是回滚。如果在宽限期过后事务未完成，那么控制器将异常终止运行该应用程序组件的服务方区域，并且报告 ABEND EC3 RSN=04130002 或 04130005。

注： 只有事务生存期超时总计和最长事务超时才有宽限期。可使用 DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD 定制属性禁用宽限期。

此超时的上限受最长事务超时限制。例如，如果将事务生存期超时总计的值设为 500，并且将最长事务超时的值设为 300，那么事务将在 300 秒后超时。

如果将此超时设置为 0，那么不会应用超时并且会使用最长事务超时的值。

信息	值
数据类型	整型
单位	秒
缺省值	120
范围	0 到 2 147 483 647
范围	0 到 2 147 040

指定时间长度（以秒计），服务器在这段时间内等待入站 Web Service 原子事务 (WS-AT) 协议响应，然后重新发送先前的 WS-AT 协议消息。

指定来自远程客户机的事务请求之间的最大持续时间（以秒计）。任何超出此超时值的客户机不活动时间段都将导致在此应用程序服务器中回滚事务。

如果将此值设置为 0，那么表示没有超时限制。

指定完成在此服务器中运行的事务的最大时间（以秒计）。此值应大于或等于为“事务超时总时间”所指定的值。指定完成在此服务器中运行的事务的最大时间（以秒计）。此值应大于或等于事务生存期超时总时间且大于或等于应用程序组件超时。如果最大事务超时设置值小于事务生存期超时总时间或应用程序组件超时，那么当达到最大事务超时值时可能需要更多时间的应用程序组件事务将超时。

此超时会约束所有其他事务超时时间段的上限。

如果将超时设置为 0，那么不会应用超时并且会有效地将其禁用。如果将所有超时设为 0，那么事务永不超时。

为了快速确定是否发生了超时以及防止进一步发生资源锁定，应用程序服务器将阻止在发生超时的事务路径上处理更多事务工作。这对于以下情况同样成立：尝试在当前事务上下文下执行工作以及尝试在其他事务上下文下执行工作。

信息	值
数据类型	整型
单位	秒
缺省值	300
范围	0 到 2 147 483 647
范围	0 到 2 147 040

指定应用程序服务器重试完成信号（如落实或回滚）的次数。资源管理器或远程伙伴发生瞬态异常后，或者配置的异步响应超时到期而所有 Web Service 原子事务 (WS-AT) 伙伴尚未响应，那么会进行重试。

如果应用程序服务器放弃重试，那么资源管理器或远程伙伴负责确保能正确完成事务的资源部分或伙伴部分。应用程序服务器（代表资源或伙伴）抛出异常，指出试探性过程有危险。如果发出了落实请求，那么在执行落实操作时事务发起方会接收到异常；如果事务是容器启动的，那么容器会将远程异常或 Enterprise JavaBeans (EJB) 异常返回给 EJB 客户机。

在分布式事务中的下级服务器的恢复期间，当超出试探性重试次数时，试探性完成方向属性指定事务是如何完成的。

资源管理器或远程伙伴发生瞬态异常之后，应用程序服务器在重试完成信号（如落实或回滚）之前等待的秒数。

指定应用程序服务器是否记录既涉及一阶段落实资源又涉及两阶段落实资源的事务的“准备落实一阶段资源”事件。

此属性允许记录试探性报告。如果应用程序配置为允许一阶段落实资源参与两阶段落实事务，那么在制作应用程序服务器失败时所产生的试探性结果报表时，需要在事务日志中写入其他信息。如果启用此属性，那么对于每个既涉及一阶段落实资源又涉及两阶段落实资源的事务，另外执行一次日志写操作。不会对不涉及一阶段落实资源的事务写入其他记录。

指定用来完成具有试探性结果的事务的方向；此方向或者是应用程序服务器落实或回滚该事务，或者是依靠管理员手动完成该事务。

此属性仅适用于上述情况中的事务。

指定此服务器上的所有应用程序是否接受在包含一阶段资源的两阶段事务中产生试探性风险的可能性。此设置将为服务器配置最后参与者支持（LPS）。最后参与者支持是对事务服务的扩展，它使单个一阶段资源能够参与涉及一个或多个两阶段资源的两阶段事务。

如果未选择“接受试探性风险”选项，那么必须逐个配置应用程序以接受试探性风险。可以在装配应用程序时对他们进行配置，也可以在部署之后使用最后参与者支持扩展窗格来配置应用程序。

指定打开事务服务恢复日志时是否使用文件锁。

指定是否以安全方式交换事务服务协议消息。

启用事务协调授权后，事务服务在处理事务之前将验证是否允许调用者具有管理员角色。

除非对服务器启用了 WebSphere Application Server 安全性，否则此设置无效。

指定缺省 WS-Transaction 规范级别，以用于包含 Web Service 原子事务 (WS-AT) 或 Web Service 业务活动 (WS-BA) 协调上下文的出站请求。

可选择 WS-Transaction 1.0、WS-Transaction 1.1 或 WS-Transaction 1.2。有关这些规范的详细信息，请参阅应用程序服务器中的 WS-AT 支持或 WS-BA 支持的主题。

如果无法根据提供程序策略（WS-Transaction WS-Policy 断言）来确定级别，那么将使用缺省 WS-Transaction 规范级别。例如以下情况：目标 Web Service 的 WSDL 或者客户机的 WS-Transaction 策略类型中都没有提供策略断言；或者，虽然提供了策略断言，但是多个规范级别适用。

选择或指定外部 WS-Transaction HTTP(S) URL 前缀。

• 如果您正在使用中间节点（例如，HTTP Server 或 Proxy Server for WebSphere）来发送符合 Web Service 原子事务 (WS-AT) 协议或 Web Service 业务活动 (WS-BA) 协议的请求。
• 如果您想要将 WS-Transaction 端点引用配置为通过非缺省协议来发布，那么主机或端口值位于它们的 URL 中。例如，当配置入站 WS-Transaction 协议请求通过转发代理（例如，WebSphere 代理服务器）流入应用程序服务器时，如果未启用全局安全性，那么使用此字段来指定 SSL 通道；如果已启用全局安全性，那么使用此字段来指定非 SSL 通道。

如果配置了所指定的定制前缀或者所选择的前缀，那么使用该前缀。如果未设置所指定的定制前缀或者所选择的前缀，并且启用了安全性，那么缺省情况下会自动选择应用程序服务器的启用了 SSL 的 Web 容器通道链。否则，会自动选择启用了非 SSL 的 Web 容器通道链。

避免故障： 事务协调授权的设置对于是否选择了 SSL/非 SSL 没有影响。有关事务协调授权与 WS-Transactions 之间的关系的更多信息，请参阅“在安全环境中配置 Web Service 事务支持”主题。gotcha

如果中间节点不是 Proxy Server，那么每个服务器的前缀都必须是唯一的。

如果正在使用 Proxy Server，那么对于集群中的每个服务器，前缀可以是相同的，这是因为 Proxy Server 动态确定要将请求转发到哪个服务器。

选择此选项，以从列表中选择要用于 WS-AT 和 WS-BA 服务端点的外部端点 URL 信息。

选择此选项，以在字段中指定要用于 WS-AT 和 WS-BA 服务端点的外部端点 URL 信息。

http://host_name:port

https://host_name:port

指定等待管理员手动完成的事务数。

如果有等待手动完成的事务，那么可以单击查看链接，以显示需要手动完成的事务面板上的那些事务列表。

指定正在重试某些资源的事务数。

如果有正在重试资源的事务，那么可以单击查看链接，以在“正在重试资源的事务”面板上显示那些事务的列表。

指定已经以试探方式完成的事务数。

如果有已经按试探方式完成的事务，那么可以单击查看链接，以在“具有试探性结果的事务”面板上显示那些事务的列表。

指定已导入并已就绪但尚未落实的事务数。

如果有已导入且已就绪但尚未落实的事务，那么可以单击查看链接，以在“已导入且就绪的事务”面板上显示那些事务的列表。

可以单击“其他属性”下的定制属性链接以显示或更改 WebSphere Application Server 事务服务的定制属性。

使用定制属性以指定事务服务恢复期间参考消息是否显示在管理控制台上并写入 SystemOut.log 文件。

要了解有关 WebSphere Application Server 事务服务定制属性的更多信息，请参阅相关链接。