Checking whether any tasks failed

Document processing might be stopped because a task was configured incorrectly or the task is missing parameters.

Error identification

Search the IBM® Content Collector Task Routing Engine service log file for any tasks that failed because the task was configured incorrectly and is missing important parameters. These errors are logged depending on the log level that you defined for the IBM Content Collector Task Routing Engine service in the IBM Content Collector Configuration Manager under Tools > Task Route Service Configuration.

Ensure that you set the adequate log level to identify this kind of error and run the task route again before you begin searching for error strings. The default log file directory is ContentCollector-install-directory\ctms\Log.
Table 1. IBM Content Collector Task Routing Engine service log file and messages
IBM Content Collector Task Routing Engine service log file Log level Search strings
ICC-install-directory\ctms\Log\ibm.ctms.taskrouteservice* where * is a placeholder for the date and possibly a file number. Warning Search for the following string in the log file messages that indicates that a task failed, filtered by the thread ID:
  • Error*

Action

Table 2. Action after error identification
Result Action
A task failed
  1. If the task route contains decision points, review them to see if a decision point is filtering out input that should be processed. Use audit log tasks after decision points to track where inputs is being routed.

    Check that you used an Always true rule in the decision point. If you did not, and all rules return false, the document is filtered out altogether. This error is not caught and logged by the audit log task after the decision point. This error is logged as a warning message in the IBM Content Collector Task Routing Engine service log file with the form 'No rules apply for work item '%|1$|',....'.

    If decision points are added to the task route to intentionally filter out certain documents, ensure that you add an always true rule to the decision point and have the rule route these documents to an audit log task.

  2. Check the audit log task log files for errors. The default audit log file name is ibm.ctms.taskrouting_auditlog. The default audit log file directory is ContentCollector-install-directory\ctms\audit.
  3. Did the task fail because metadata was missing?
No task failed Did the connector fail?