How to enable rules logging for Taskmaster Web with IBM Datacap Taskmaster Capture

How to enable rules logging for

Taskmaster Web with IBM Datacap

Taskmaster Capture

Abstract

How to enable RRS or rules logging for Taskmaster Web tasks.

Cause

Rules logging, also known as RRS logging, is invaluable for troubleshooting unexpected results or behavior in an environment since it will log the actions being called by the application. RRS logging for Taskmaster Web can be enabled for any task that uses rules such as Verify. This type of logging will not apply to non-rules based tasks such as Upload or certain web scanning.

Answer

To enable RRS logging:

1. Locate the BPP or ICP file used by the web task.


2. Backup the file and then open the original using Notepad.


3. Locate the section [RRC] or add one if it does not exist.


4. Add the following values beneath [RRC]:

Setting​	Description​
BatchLog=1​	Turns logging on​
ServiceLog=3​	Log verbosity, 1-5 where max is 5​
ActionLogLevel=5​	Log verbosity, 1-5 where max is 5​
LogReflush=0​	Periodic writes to the log file (less file I/O required)​

1. Save changes.

When ServiceLog is set to 4 or 5, interbatch or WRRS logs are created. In Taskmaster 7.6 and earlier this is in the \Datacap\RRS folder on the Taskmaster Server. In Taskmaster 8.0.0 and later this is either the local \Datacap\RRS\Logs folder or the one on the Taskmaster Server depending on configuration for that web server -- see Settings | RRS in Datacap Studio or HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Datacap\RRS\locations (REG_SZ) RRS.

Logging verbosity is primarily controlled by the ServiceLog setting. The ServiceLog and ActionLogLevel settings can be tweaked for logging severity that is most appropriate for business requirements.

Web based tasks do not move the log file to the batch directory until the task has been completed or placed on hold. Until then, such logs may be found on the web server under the corresponding cache folder in \Datacap\TaskRun.