Transaction service custom properties

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

New feature New feature: This topic references one or more of the application server log files. Beginning in WebSphere Application Server Version 8.0 you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.newfeat

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.

You can define the following transaction service custom properties:

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. The table includes the data type, acceptable values, and default for the property.
Data type Boolean
Acceptable values TRUE, FALSE
Default FALSE

DISABLE_RECOVERY_AUDIT_LOGGING

You can control 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.

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.

Table 2. DISABLE_RECOVERY_AUDIT_LOGGING custom properties. The table includes the data type, acceptable values, and default for the property.
Data type Boolean
Acceptable values TRUE, FALSE
Default

FALSE

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.

Table 3. REMOVE_PARTNER_LOG_ENTRY custom properties. The table includes the data type, acceptable values, and default for the property.
Data type Integer
Acceptable values (one or more comma-delimited integer recovery ID)
Default (null)



Related tasks
Displaying transaction recovery audit messages
Delaying the cancelling of transaction timeout alarms
Removing entries from the transaction partner log
Using HPEL to troubleshoot applications
Using the transaction service
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 4:16:02 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-base-dist&topic=rjta_transerv_custproperties
File name: rjta_transerv_custproperties.html