Configure transaction properties for an application server

You configure the transaction properties for an application server, such as defining the location of the directory that contains the transaction log or changing the default timeouts associated with transactions. For more information about transaction service properties, see Transaction service settings.

Perform the following steps in the administrative console to configure transaction properties:

1. Start the administrative console.

2. In the topology tree, expand Servers, and click Application Servers.

3. Click the name of the application server for which you want to configure transaction properties.

4. Select the Transaction Service tab to display the properties page for the transaction service. You can edit configuration properties or runtime properties.

   • Configuration
     The values of these properties are defined in the configuration file. If you change these properties, the new values are applied the next time you start the application server.
   • Runtime
     The runtime values of properties. If you change these properties, the new values are applied immediately, but are overwritten with the configuration values the next time you start the application server.

5. Select the Configuration tab to display the configuration properties for transactions, or the Runtime tab to display the runtime properties for transactions. You can edit these properties:

   • Transaction log directory
     This property specifies the directory in which transaction logs are written. To change the property, specify the fully-qualified pathname of the directory. You must specify an existing directory name.

     Note: If you change the transaction log directory, apply the change and restart the application server as soon as possible, to minimize the risk of problems caused that might occur before the application server is restarted. For example, if a problem causes the server to fail (with active transactions), the server next starts with the new log directory and is unable to automatically resolve active transactions that were recorded in the old log directory.

   • Default log file size
     If you want to change the default file size of transaction log files, modify the Transaction log directory field to include a file size setting, in the following format:

     directory_name;file_size

     where directory_name is the name of the transaction log directory, and file_size is the new default size specified in bytes. Use the K or M suffixes to indicate kilobytes or megabytes, respectively. If you do not specify a file size value, the default value of 1M is used. For example, c:\tranlogs;2M indicates the files are to be created in the directory c:\tranlogs and limited to 2MB in size.

     In a non-production environment, you can use the transaction log directory value of ;0 to disable transaction logging. There must be no directory name element before the size element of 0. It is recommended that you not disable transaction logging in a production environment. Transaction logs are required for recovery after a system failure, and data integrity cannot be guaranteed without the logs.

   • Total transaction lifetime timeout
     This property specifies the number of seconds a transaction can remain inactive before it is ended by the transaction service. A value of 0 (zero) indicates that there is no timeout limit.

   • Client inactivity timeout
     This property specifies the number of seconds after which a client is considered inactive, and the transaction service ends any transactions associated with that client. A value of 0 (zero) indicates that there is no timeout limit.

6. Click OK.

7. (Optional) If you make changes to configuration properties, save the configuration.

8. (Optional) If you make changes to configuration properties, restart the application server.