Viewing Rulerunner processing logs

The Rulerunner processing logs provide information to help identify the cause of error conditions. The error conditions might include Datacap server connection failures, inconsistent domain account group names for authentication, or incorrect database path structures in the Application Manager.

To view Rulerunner processing logs:

1. On the Rulerunner server, start Windows Explorer, open the folder in which the logs were created. The default is C:\Datacap\. The folder is defined by Rulerunner Manager. Click the Logging - Rulerunner Log tab and select Output to folder.
2. Open the Rulerunner.log file in a text editor such as Notepad and look for errors.
3. Open the Rulerunner thread log files in a text editor. Look for the messages that begin with EstablishConnection. A successful log would be similar to this example:

   EstablishConnection: Connecting to application [APT]. 
   EstablishConnection: GetServer returned [127.0.0.1]. 
   EstablishConnection: Connecting to TM Server [127.0.0.1:2402]. 
   EstablishConnection: Connecting to Admin DB 
   [PROVIDER=MSACCESS;DSN=C:\Datacap\APT\APTAdm.mdb;]. 
   EstablishConnection: Connecting to Engine DB 
   [PROVIDER=MSACCESS;DSN=C:\Datacap\APT\APTEng.mdb;]. 
   EstablishConnection: TM Login [admin station=1]. 
   EstablishConnection: Login successful.

4. Error conditions can include one or more of the following examples:
   • If you are connecting to the Datacap Server fails, then the Datacap Server Service is not responsive or a network failure occurred.
   • If you are connecting to the Admin or Engine database of the application fails, use the Datacap Application Manager. To ensure that the paths to the databases are correct.
   • If Rulerunner fails to log in to the Datacap Server, do the following steps.
     • Ensure that the Rulerunner Service is set up properly by reviewing the Rulerunner related instructions.
     • Ensure that the Rulerunner domain account was added to the correct security group. And, in your Datacap application, a matching group is set up with a name that ends in the complete domain name (for example, XYZ.com, not XYZ).
5. On the Server, start Windows Explorer, go to and open the batches folder of the application. The default folder is C:\Datacap\Application\Batches.
6. Open the taskname_rrs.log in a text editor and look for errors. For example, open pageid_rrs.log or recognize_rrs.log.

   During processing, when Rulerunner fails to run a batch from a particular application, there is a delay interval before the next attempt.Rulerunner doubles the delay each time 2 - 64 seconds.