Error starting client service in Taskmaster Client Service Manager - Cannot start service DCTMSub on computer

Reason:

This error message is commonly displayed if the account running the Datacap Taskmaster Client Service on the Rulerunner has insufficient permissions to the local machine, or if the service is disabled.

Solution:

Open the Services control panel from Administrative Tools:

1. If the service's start up mode is disabled, then change it to be automatic or manual.

2. Set the service account to a local administrator account that has sufficient permissions to network resources such as the batches directory and application rules files.

Note: Test after making required changes. If the problem persists, consider performing a repair or reinstall of the Taskmaster software using a local admin account.

Running a custom .NET Taskmaster action results in batch aborting with RRS log message "couldn't load needed object"

Signs:

Batch logging will state something similar to the following:

Error (385875972=hex:17000004). In CCom::Call: Couldn't load needed object: Datacap.Libraries.vScanSample.Actions into Datacap.Libraries. vScanSample.Actions instance [api source:]

Reason:

This issue can occur if the .NET action components are not installed properly.

Solution:

When using the vScanSample .NET template actions available from the IBM Datacap Taskmaster Capture 8.0.1 Publication Library, compiling the project will generate new files including interop DLL's, vScanSample.dll, vScanSample.tlb and vScanSample.pdb. Place vScanSample.dll into \Datacap\dcshared\NET and register it using regasm.exe and the /codebase flag:

C:\Windows\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe C:\Datacap\dcshared\NET\vScanSample.dll /codebase

Re-run the actions when finished to confirm the solution.Note: If the problem persists with a more customized project then unregister the main DLL and place it into a sub-folder along with all other compiled components (interops, main DLL and TLB file). Re-register vScanSample.dll using regasm.exe and the /codebase flag before reprocessing; the set of files specific to your project can be isolated afterward.

How to set Hotkeys in IBM Datacap Taskmaster Batch Pilot Verify

Steps to create custom a custom hot key:

1. Open verify DCF form in Batch Pilot.
2. Go to Form > Hotkeys.
3. Make sure the Form button is pressed.
4. Place cursor in 'Selected key combination'.
5. Press the hotkeys wanted for use.
6. Add Title of hotkey.
7. Click the Add button.
8. Note the Hot Key index number.
9. Add the Hot Key index value as a new Select case in the Pilot_OnHotKey event with the desired code. For example if the HotKey index is 10 the Select Case needs to be Case 10.
10. Save form.

Is the "LOOKUP" variable, that is added to a line item field, supported to work in the thin client verify panel prelayout.aspx

No, unfortunately prelayout.aspx does not have the capability for line item fields to be filled in with values based on a Lookup. Neither does aptlayout.aspx. Pages that can perform this capability are averify.aspx, and aindex.aspx.

How can you programmatically send keystrokes in Batch Pilot

To send keystrokes via Batch Pilot scripting, you can invoke the WScript.Shell object's SendKeys method. The following is an example for sending Ctrl + N:

Dim shell

Set shell = CreateObject("WScript.Shell")

shell.SendKeys("^n")

Set shell = Nothing

Note: Some hot keys may be alternatively accomplished. For example, calling Pilot.BatchContinue is equivalent to clicking the Navigate to Next Problem button

Taskmaster Application Manager crashes when updating one or more fields in Datacap

Taskmaster Application Manager crashes when updating one or more fields with the message box stating "Debug Error! [...]" is displayed.

Signs:

Fields in Taskmaster Application Manager are disabled. Editing fields causes the following "Microsoft Visual C++ Debug Library" message box:

"Debug Error! \ Program: C:\Datacap\tmclient\DCOrchard.exe \ abnormal program termination \ (Press Retry to debug the application)

Pointing to a Datacap.xml in another environment may work.

Reason:

The application file, <app_name>.app, is locked

Solution:

First confirm that this Technote applies to your situation. See other Technotes for other scenarios where similar but not exactly identical behavior may apply. Some of those resolutions include:

- Installing Datacap Studio on the machine running Taskmaster Application Manager

- Installing IBM Datacap Taskmaster Capture 8.x on UAC-enabled PC's using Run as Administrator

- Installing Microsoft.NET Framework 3.5.1

 

Second, confirm that your problem is not resolved when right-clicking and running the Taskmaster Application Manager shortcut or executable using the Run As Administrator command.

 

Third, confirm that all following paths point to the correct locations:

1. Path to datacap.xml file as indicated in Service tab of Taskmaster Application Manager:

- x64: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Datacap\Application\Location\'TopPath'

- x86: HKEY_LOCAL_MACHINE\SOFTWARE\Datacap\Application\Location\'TopPath'

2. Path to the general Datacap application folder inside the datacap.xml file

- This is inside the "ref" tag, which generally defaults to a local path or folder

Fourth, ensure that the Windows user has full sharing and security permissions to the application file. Try creating a file or folder where the application file is located.

Lastly, see if using the Taskmaster Application Manager when pointed to another environment works and/or if there are locks against the application file in question using a program such as Microsoft's Process Explorer.

Note: In case the application file is locked, try rebooting the server on which the application file is hosted. If this is the Taskmaster Server, this will affect all clients, including Rulerunners, Taskmaster Client and Taskmaster Web. Alternatively, try using a program such as Process Explorer to detect and kill any unnecessary file locks. The latter must be done carefully and is not generally recommended.

Is Net Framework 4.0 compatabil with Datacap on Microsoft Server 2008 R2 64 bit

No, IBM Datacap Taskmaster Capture was built to run on Microsoft .Net 3.5.1 framework. It has not been fully tested to be run with .Net 4.0.