Checking whether documents were received by the IBM Content Collector Task Routing Engine service

Source documents can only be processed and archived if they are received by the IBM Content Collector Task Routing Engine service for processing by the tasks.

Error identification

Search the IBM Content Collector Task Routing Engine service log file to identify whether documents were actually received by the IBM Content Collector Task Routing Engine service and can be processed by the tasks in the task route. This information is 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. Trace 2 Search for the following strings:
  • received collector
The messages have the following format:
Received collector 
output from '%|1$|' 
for entities : '%|2$|'

Action

Table 2. Action after error identification
Result Action
Documents were received Is the correct task route assigned?
Search string was not found Check the IBM Content Collector Task Routing Engine service log for warnings or errors.
Begin by looking in the IBM Content Collector Task Routing Engine service log file for the following messages that might be an additional indication why documents could not be received for processing.
Table 3. Error and warning messages in the IBM Content Collector Task Routing Engine service log file
Warning or error message Action
Warning: Ignoring submission because memory usage is too high. This message is logged if at least 80 percent of the system's memory, that is the sum of the physical memory and the page file, is in use at the point when the collector tries to submit the document for processing. Most likely, the system is overloaded. You should use a tool like Task Manager, Process Explorer or Performance Monitor to determine which processes are using memory on your system. Shut down any processes that are not necessary for document processing. If this warning still persists, you should either add memory or reduce the load that IBM Content Collector is putting on the system. One way to reduce the load on the system is to change the IBM Content Collector Task Routing Engine service thread pool settings. You can either reduce the number of threads in the thread pool, or the size of the thread pool queue. Reducing the number of threads is more effective than reducing the queue size.
Error: Ignoring entity submission because it was submitted by sever name which is not the current primary node. If the node only just failed, no action is necessary. If the node has been available the whole time, contact IBM Software Support.
Error: Ignoring entities with empty string specified for collecting or processing server name. Contact IBM Software Support.