Configure transaction properties for an appserver

 

To configure the transaction properties for an appserver:

  1. Start the Administrative console

  2. Go to:

    Servers | Application Servers | app_server | Transaction Service tab | Configuration tab

  3. To set the directory in which transaction logs are written, type the full pathname of the directory in the Transaction log directory field. To check the current runtime value, click the Runtime tab.

    One can also specify a size for the transaction logs, as described in the following step.

    If you change the transaction log directory, apply the change and restart the appserver 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 in-flight transactions), the server next starts with the new log directory and is unable to automatically resolve in-flight transactions that were recorded in the old log directory.

  4. 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

    • file_size is the new default size specified in bytes. The nK or nM suffix can be used to indicate kilobytes or megabytes. If you do not specify a file size value, the default value of 1M is used.

    For example, /opt/WebSphere/AppServer/tranlogs;2M indicates the files are to be created with 2M bytes size and stored in the directory c:\tranlogs.

    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.) You should not disable transaction logging in a production environment, because this prevents recovery after a system failure and, therefore, data integrity cannot be guaranteed.

  5. In the Total transaction lifetime timeout field, type 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.

  6. In the Client inactivity timeout field, type 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.

  7. Click OK.

  8. Cycle appserver.

    If you change the transaction log directory configuration property to an incorrect directory name, the appserver will restart but be unable to open the transaction logs. You should change the configuration property to a valid directory name, then restart the application server.

 

See also:

  1. Using the transaction service
  2. Transaction service settings

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.