Transaction service custom properties

WebSphere® Application Server allows you to configure a number of custom properties for transaction services.

Transaction service custom properties can be specified in the administrative console. To use any of these custom properties click on Servers > Server Types > WebSphere application servers > server_name > [Container Settings] Container Services > Transaction Service > [Additional Properties] Custom Properties.

[z/OS] Avoid trouble: In z/OS® ensure that all relevant log streams are set to AUTODELETE(NO).gotcha
You can define the following transaction service custom properties:
[Fix Pack 13 or later]
DELAY_CANCELLING_ALARMS

If the before completion stage of a transaction process is likely to include processes that could either take a long time to complete or could fail, then you might want the transaction to time out.

By default, transaction timeout alarms are cancelled prior to the before completion phase of the transaction begins. The DELAY_CANCELLING_ALARMS custom property allows the before completion phase of the transaction to be encompassed within the transaction timeout period. To do this, set the custom property on the application server.

Table 1. DELAY_CANCELLING_ALARMS custom properties
Data type Boolean
Acceptable values TRUE, FALSE
Default FALSE
[z/OS]
DISABLE_OUTBOUND_CASCADED_SUPPORT

Specifies whether or not the transaction manager is to disable the support that allows initiating cascaded transactions and be able to let other WebSphere Application Servers on z/OS, who also support RRS cascaded transaction processing, be part of a cascaded family.

Set this value to true if you do not want outbound cascaded support. Setting this value to true will prompt the server to default to standard JTS transaction propagation.

Table 2. DISABLE_OUTBOUND_CASCADED_SUPPORT custom properties
Data type Boolean
Acceptable values TRUE, FALSE
Default FALSE
[Fix Pack 13 or later]
DISABLE_RECOVERY_AUDIT_LOGGING

You can choose whether information messages are displayed on the administrative console and written to the SystemOut.log file upon transaction service recovery. To do this, set the DISABLE_RECOVERY_AUDIT_LOGGING custom property for the transaction service for the server.

[AIX Solaris HP-UX Linux Windows] On distributed platforms the default is for information messages to appear both on the administrative console and in the SystemOut.log file during the recovery of transaction services. If you do not want these messages to be displayed you can use the DISABLE_RECOVERY_AUDIT_LOGGING custom property.

[z/OS] On z/OS® information messages do not appear by default, either on the administrative console or in the SystemOut.log file during the recovery of transaction services. If you want these messages displayed you can use the DISABLE_RECOVERY_AUDIT_LOGGING custom property.

[z/OS] Note: On z/OS, if you choose to turn on transaction recovery audit messages, other audit messages (such as those relating to servant recovery and XA resource recovery) are also displayed in the console and the SystemOut.log file.
Table 3. DISABLE_RECOVERY_AUDIT_LOGGING custom properties
Data type Boolean
Acceptable values TRUE, FALSE
Default

[AIX Solaris HP-UX Linux Windows] FALSE

[z/OS] TRUE

[z/OS]
DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD

Specifies whether there is a delay between a transaction timeout and the abnormal ending of the servant region that was running the transaction.

If you set this value to false, a global transaction that times out is marked rollback-only. The transaction server gives the associated application an additional period of time, approximately four minutes, to complete. If the application completes in this time, the transaction is rolled back. If the application does not complete in this time, the application and associated servant region are ended abnormally, with an ABENDEC3 or ABENDSEC3 error.

Set this value to true to remove the delay, and abnormally end the application and servant region immediately.

Table 4. DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD custom properties
Data type Boolean
Acceptable values TRUE, FALSE
Default FALSE
[z/OS]
DISABLE_WSTX_RMFAIL_LOGGING

Specifies whether an RMFAIL message is sent to the error log file when a WS-AT participant fails to send a response within the asynchronous response timeout period, causing an XAER_RMFAIL transaction exception to occur.

If you set this value to false, an RMFAIL message is sent to the error log file when a WS-AT participant fails to send a response within the asynchronous response timeout period.

Set this value to true if you do not want an RMFAIL message sent to the error log file when a WS-AT participant fails to send a response within the asynchronous response timeout period.

Table 5. DISABLE_WSTX_RMFAIL_LOGGING custom properties
Data type Boolean
Acceptable values TRUE, FALSE
Default FALSE
[Fix Pack 13 or later]
REMOVE_PARTNER_LOG_ENTRY

You can remove entries from the transaction partner log file. To do this, set the REMOVE_PARTNER_LOG_ENTRY custom property for the transaction service on the server that owns the partner log.

As part of the transaction recovery process, the partner log is checked to establish which resources are needed. If you want to remove certain entries from the partner log, such as a resource that no longer exists, set this custom property on the application server that owns the transaction partner log containing the entries you want to remove.

The REMOVE_PARTNER_LOG_ENTRY custom property is effective only when both of the following situations apply.

  • The application server is started in recovery mode.
  • The application server has no transactions that currently require recovery. You can establish this by checking the SystemOut.log file.
Table 6. REMOVE_PARTNER_LOG_ENTRY custom properties
Data type Integer
Acceptable values (one or more comma-delimited integer recovery ID)
Default (null)
[z/OS]
RLS_LOGSTREAM_COMPRESS_INTERVAL

Specifies, in seconds, the interval at which the recovery log service attempts to compress any log streams application components are using. The Transaction Service (XA partner log) and the Compensation Service components can be configured to use the recovery log service.

The log stream is checked for compression once per interval. This operation can cause unnecessary CPU usage if the log stream is not being used.

Note:
  • If you do not use a log stream for the compensation service, set this property to a value that is higher than the default value.
  • If your recovery log service uses log streams, do not set this property to too high a value. If the recovery log service log streams become full before the compression interval expires, transactions might start to fail until the log streams are compressed.
  • If none of your components are configured to use a log stream, you set this property to 0 (zero) to disable this function.
Table 7. RLS_LOGSTREAM_COMPRESS_INTERVAL custom properties
Data type Integer
Acceptable values 0 - 2,147,483,647 (0 disables the function)
Default 30 seconds



Related tasks
[Fix Pack 13 or later] Displaying transaction recovery audit messages
[Fix Pack 13 or later] Delaying the cancelling of transaction timeout alarms
[Fix Pack 13 or later] Removing entries from the transaction partner log
Using the transaction service
Concept topic    

Terms of Use | Feedback

Last updated: Oct 22, 2010 3:02:28 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v700osgijpa&product=was-nd-mp&topic=transactionservicecustomproperties
File name: rjta_transerv_custproperties.html