Enabling error logging in the desktop Process Designer (deprecated)

You can configure IBM® Process Designer to log errors by using log4J or java.util.log. 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 and java.util.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:
  1. Close Process Designer.
  2. Locate the file twappserver.jar in the directory
    <ProcessDesignerInstallationDirectory>\teamworks\eclipse\plugins\teamworks.appserver.websphere_version\lib
  3. From twappserver.jar, extract the file log4j.xml to the root Process Designer installation directory.
  4. 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>
  5. Open eclipse.ini and point to the updated log4j.xml by adding this line:
    -Dlog4j.configuration=file:<ProcessDesignerInstallationDirectory>/log4j.xml
  6. 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 java.util.logging messages, follow these steps:

  1. Close Process Designer.
  2. Navigate to the main Process Designer installation directory.
  3. Open TraceSettings.properties. Uncomment the line for the classes that you want to trace.
  4. Restart Process Designer, recreate the problem and examine the java.util.log file for errors. The java.util.log file is located in the Process Designer installation directory.