[AIX HP-UX Linux Solaris Windows]This topic applies only on the z/OS operating system.

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 by clicking Servers > Application Servers > server > Container Services > Transaction service > Custom Properties > New.

Avoid trouble Avoid trouble: Set AUTODELETE(NO) for any logstreams.gotcha

DELAY_CANCELLING_ALARMS

[z/OS] [AIX HP-UX Linux Solaris Windows] [Fix Pack 33 or later]

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

REMOVE_PARTNER_LOG_ENTRY

[z/OS] [AIX HP-UX Linux Solaris Windows] [Fix Pack 33 or later]

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.

Table 2. REMOVE_PARTNER_LOG_ENTRY custom properties
Data type Integer
Acceptable values (one or more comma-delimited integer recovery ID)
Default (null)

DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD

[z/OS]

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 3. DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD custom properties
Data Type Boolean
Acceptable values true, false
Default false

DISABLE_WSTX_RMFAIL_LOGGING

[z/OS]

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 4. DISABLE_WSTX_RMFAIL_LOGGING custom properties
Data Type Boolean
Acceptable values true, false
Default false

RLS_LOGSTREAM_COMPRESS_INTERVAL

[z/OS]

Specifies, in seconds, the interval at which the recovery log service attempts to compress any logstreams 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 logstream is checked for compression once per interval. This operation can cause unnecessary CPU usage if the logstream is not being used.

Recommendations:
Table 5. 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
[z/OS] [AIX HP-UX Linux Solaris Windows] [Fix Pack 33 or later] Delaying the cancelling of transaction timeout alarms
[z/OS] [AIX HP-UX Linux Solaris Windows] [Fix Pack 33 or later] Removing entries from the transaction partner log
Using the transaction service
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=rjta_transerv_custproperties
File name: rjta_transerv_custproperties.html