Log data for the Business Automation Workflow configuration tool

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15

The workflow configuration tool displays log messages in the console window when you run a task. To review the log, select Window > Show View > General > Error Log.

The configuration tool stores the log data for the duration of the session. When you restart the tool, the session log file is cleared.

Tip: You can select and copy the contents of log messages from the console window.

The configuration tool log file is in the logs directory in the location where you installed Business Automation Workflow.

Table 1. Default location of the workflow configuration tool log files
Operating system	Default file path
AIX® Linux® Linux for System z®	/opt/IBM/CaseManagement/logs/IBM_Case_Manager_5.2.1.0_CMCT.log /opt/IBM/CaseManagement/logs/IBM_Case_Manager_5.2.1.0_CMCT_trace.log.
Windows	`drive`:\Program Files (x86)\IBM\CaseManagement\logs\IBM_Case_Manager_5.2.1.0_CMCT.log `drive`:\Program Files (x86)\IBM\CaseManagement\logs\IBM_Case_Manager_5.2.1.0_CMCT_trace.log

The workflow configuration tool uses a set of log files to store trace information. The files in that set are written to in order. When the log files in the set reach the maximum allowed size, the oldest file is overwritten and the pattern is repeated. To increase or decrease the amount of data stored, you can adjust the size of each log file and the number of log files that the configuration tool uses. These values are stored in the following properties file.

Table 2. Default location of the cmlogging.properties file
Operating system	Default file path
AIX Linux Linux for System z	/opt/IBM/CaseManagement/configure/configuration/cmlogging.properties
Windows	`drive`:\Program Files\IBM\CaseManagement\configure\configuration\cmlogging.properties

The following example shows part of cmlogging.properties file:

# Only setup logging to files -- no Console Handling
# handlers are attached to root logger and inherited by all others
handlers = java.util.logging.FileHandler

# need it set to ALL, don't change. adjust tracing via Eclipse .options file
java.util.logging.FileHandler.level=ALL
com.ibm.ecm.configmr.level=ALL

# the next line does not actually seem to work -- formatter is also applied programmatically.
java.util.logging.FileHandler.formatter=com.ibm.ecm.configmgr.engine.util.CMLogFormatter

# set file handler to limit to 1Mb per log file, rotating 3 log files, store in user.home dir
java.util.logging.FileHandler.limit=10000000
java.util.logging.FileHandler.count=5
java.util.logging.FileHandler.pattern=C:/IBM/CaseManagement/logs/IBM_Case_Manager_5.2.1.0_CMCT%g.log

The line java.util.logging.FileHandler.limit=1000000 specifies the size of each log file in bytes. The line java.util.logging.FileHandler.count=5 specifies the number of log files that the configuration tool uses. To change how much trace logging data the configuration tool uses, change one or both of these values.

The task logs and temporary script files are in the /logs/tmp directory in the location where you installed Business Automation Workflow. The task name is used in the file name.

Table 3. Default location of the configuration tool task log files
Operating system	Default file path
AIX Linux Linux for System z	/opt/IBM/CaseManagement/configure/tmp/`task_name`.log
Windows	`drive`:\Program Files\IBM\CaseManagement\configure\tmp\`task_name`.log