Enabling error logging in Process Designer

You can configure IBM® Process Designer to log errors by using log4J or java.util.logging. You can then examine the logs to troubleshoot problems with Process Designer.

Traces and logs

Error logs and traces can be located in a number of different places within the Process Designer installation directory. You can find ae.log in the main directory where Process Designer is installed. Other logs are located in the <ProcessDesignerInstallationDirectory>\workspace\metadata directory.

You can use the information in these logs to troubleshoot a problem. If you need to contact IBM Support, submit these logs to get the problem resolved faster.

Enabling log4J debug tracing

Configure Process Designer to add debug statements to the ae.log file:

Close IBM Process Designer.

Locate the file twappserver.jar in the directory

<ProcessDesignerInstallationDirectory>\teamworks\eclipse\plugins\teamworks.appserver.websphere_version\lib

From twappserver.jar, extract the file log4j.xml to the root Process Designer installation directory.

In log4j.xml, change the level value for the com.lombardisoftware logger from error to debug.

The log4j.xml file should be changed from:

<logger name="com.lombardisoftware" additivity="false">
<level value="error" />                                                                                                              
<appender-ref ref="TWConsoleAppender" />                                                                                             
<appender-ref ref="TWFileAppender" />                                                                                               
</logger>

to:

<logger name="com.lombardisoftware" additivity="false"> 
<level value="debug" /> 
<appender-ref ref="TWConsoleAppender" /> 
<appender-ref ref="TWFileAppender" /> 
</logger>

Open eclipse.ini and point to the updated log4j.xml by adding this line:

-Dlog4j.configuration=file:<ProcessDesignerInstallationDirectory>/log4j.xml

Restart Process Designer, recreate the problem, and note down the time stamp. The ae.log file should now contain the debug and error messages from Process Designer.

Enabling java.util.logging

To enable logging for all java.util.logging messages, follow these steps:

Close Process Designer.
Navigate to the main Process Designer installation directory
Open eclipse.ini and add this line:
```
-Djava.util.logging.Level=ALL
```
Restart Process Designer, recreate the problem and examine the logs for errors.