How to enabling verbose Taskmaster Server logging in Datacap

By default the installed version of logging for Taskmaster Server is a lightweight version. This version is sufficient to log many errors, but does not offer full logging. For troubleshooting ADSI or LDAP authentication, or reviewing all low-level queries in depth given a particular problem, verbose Taskmaster Server logging may need to be enabled.

Enabling verbose logging requires a one-time step of replacing dclog.dll in the tmserver folder, which means that the server service must be stopped temporarily. Enabling, disabling or truncating the log can be done transparently.

Steps to Replacing DCLog.dll :

1. Stop and close all clients and background services
2. Backup \Datacap\tmserver\dclog.dll on Taskmaster Server
3. a) Stop the Datacap Taskmaster Server Service
b) Close the Taskmaster Server Manager
4. Replace \Datacap\tmserver\dclog.dll using a copy of \Datacap\dcshared\dclog.dll
Note: Do not move or rename the dcshared file
5. Start the Datacap Taskmaster Server Service

Steps to Enabling Taskmaster Server Logging:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Configure logging parameters:
a) Output to file = Enabled
b) Number of Messages = All or a sufficient level
c) File path and name = Normally a local disk with sufficient space
d) Reflash buffer = Normally disabled, enable if immediate log writes are required
e) Write to common buffer = Disabled
4. Click Save
5. Click Yes to immediately load settings

Steps to Disabling Taskmaster Server Logging:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Disable 'Output to file'
4. Click Save
5. Click Yes to immediately load settings
Steps to Truncating a Taskmaster Server Log:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Enable or disable and re-enable 'Overwrite existing log file'
4. Click Save
5. a) Click Yes to immediately load settings
b) Disable 'Overwrite existing log file' if desired, Save and click Yes

Note: Disk consumption should be closely monitored when logging is turned on, with full logging severity the log file can have a very rapid growth rate.