Package com.ibm.ws.ffdc
Class FFDCFilter
java.lang.Object
com.ibm.ws.ffdc.FFDCFilter
This class provides static methods to write first failure data capture (FFDC) records
to assist in debugging problems. When an unexpected exception is caught, the processException methods
can be used to record the exception stack.
For example:
catch (Exception x){
FFDCFilter.processException(x, getClass().getName(), "129", this);
throw x;
}
The source and probe identifiers combine to provide the unique
location in the source code where the FFDC record originated. Objects can also be passed for introspection
that will also be included in the FFDC record. By default, the FFDC files are written to the
${server.output.dir}/logs/ffdc directory.-
Method Summary
Modifier and TypeMethodDescriptionstatic void
processException
(Throwable th, String sourceId, String probeId) Write a first failure data capture record for the provided throwablestatic void
processException
(Throwable th, String sourceId, String probeId, Object callerThis) Write a first failure data capture record for the provided throwablestatic void
processException
(Throwable th, String sourceId, String probeId, Object[] objectArray) Write a first failure data capture record for the provided throwablestatic void
processException
(Throwable th, String sourceId, String probeId, Object callerThis, Object[] objectArray) Write a first failure data capture record for the provided throwable
-
Method Details
-
processException
Write a first failure data capture record for the provided throwable- Parameters:
th
- The throwablesourceId
- An identifier for the source of this record, for example the package and class nameprobeId
- A unique identifier within the source of this record, for example the source file line number
-
processException
public static void processException(Throwable th, String sourceId, String probeId, Object callerThis) Write a first failure data capture record for the provided throwable- Parameters:
th
- The throwablesourceId
- An identifier for the source of this record, for example the package and class nameprobeId
- A unique identifier within the source of this record, for example the source file line numbercallerThis
- The object making this call, which will be introspected for inclusion in the FFDC record
-
processException
public static void processException(Throwable th, String sourceId, String probeId, Object[] objectArray) Write a first failure data capture record for the provided throwable- Parameters:
th
- The throwablesourceId
- An identifier for the source of this record, for example the package and class nameprobeId
- A unique identifier within the source of this record, for example the source file line numberobjectArray
- An array of objects which will be introspected for inclusion in the FFDC record
-
processException
public static void processException(Throwable th, String sourceId, String probeId, Object callerThis, Object[] objectArray) Write a first failure data capture record for the provided throwable- Parameters:
th
- The throwablesourceId
- An identifier for the source of this record, for example the package and class nameprobeId
- A unique identifier within the source of this record, for example the source file line numbercallerThis
- The object making this call, which will be introspected for inclusion in the FFDC recordobjectArray
- An array of objects which will be introspected for inclusion in the FFDC record
-