Configuring first failure data capture log file purges

The first failure data capture (FFDC) log file saves information that is generated from a processing failure. These files are deleted after a maximum number of days has passed. The captured data is saved in a log file for analyzing the problem.

 

Before you begin

The first failure data capture (FFDC) feature preserves the information that is generated from a processing failure and returns control to the affected engines. The captured data is saved in a log file for analyzing the problem. FFDC is intended primarily for use by IBM Service. FFDC instantly collects events and errors that occur during the WAS runtime. The information is captured as it occurs and is written to a log file that can be analyzed by an IBM Service representative. The data is uniquely identified for the servant region that produced the exception.

The FFDC configuration properties files are located in the properties directory under the WebSphere Application Server product installation. There are three properties files, but only the ffdcRun.properties file should be modified. We can set the ExceptionFileMaximumAge property to configure the amount of days between purging the FFDC log files. The value of the ExceptionFileMaximumAge property must be a positive number. The FFDC feature does not affect the performance of the WAS product.

 

About this task

Perform the following steps to configure the number of days between the FFDC log file purges. The value is in days.

 

Procedure

  1. Open the ffdcRun.properties file.

    The file is located in the app_server_root/properties directory.

  2. Change the value for the ExceptionFileMaximumAge property to the number of days between the FFDC log file purges. The value of the ExceptionFileMaximumAge property must be a positive number. The default is seven days. For example, ExceptionFileMaximumAge = 3 sets the default time to three days. The FFDC log file is purged after three days.

  3. Save the ffdcRun.properties file and exit.

 

Results

The FFDC file management function removes the FFDC log files that have reached the maximum age and generates a message in the SystemOut.log file.


Related tasks
Working with troubleshooting tools