Problem
You have tried to execute a Mainframe process, or you have opened the Mainframe Learn (ScreenScraper) tool, and you received one or both of the following error messages:
Cause
Your ScreenScraper.xml (Mainframe interface emulator configuration) file is not specifying the correct location for your terminal emulator software. This usually occurs when either you have not chosen your Terminal Emulator (for example, Rumba) from the Tools -> Set Terminal Emulator menu in ScreenScraper or your Terminal Emulator software is not installed in its default installation location under C:\Program Files.
Solution 1
1. Make sure you have chosen the correct emulator.
2. If you still see the first error message after setting the Terminal Emulator to the correct setting, click the Yes button, navigate to where your Terminal Emulator software is installed, find the folder containing the WinHLLAPI DLL for your emulator and select it, then click Open.
NOTE: This file may not be named WinHllapi.dll. It might be Whlapi32.dll or Whllapi.dll or something similar depending on which Terminal Emulator software you are using.
Solution 2
If Solution 1 does not resolve the problem, you must manually edit the ScreenScraper.xml file to specify the correct name and location of the Windows High Level Language API (WinHLLAPI) DLL for your Terminal Emulator.
I. Locate your emulator on your Hard drive and make note of the exact name of the WinHLLAPI DLL file and the path to the file.
Example: Assuming you are using the Attachmate Extra (Reflection) emulator, you would look for the installation location of Reflection (by default, this would be "C:\Program Files\Attachmate\Reflection") and you would note that there is a "WHLAPI32.dll" file in this location.
IMPORTANT! The terminal emulator software must be physically installed on a local hard drive on your PC. The Mainframe Interface may not work correctly if your emulator software is located on a Network share.
II. Update the ScreenScraper.xml file to specify the correct location and filename for your WinHLLAPI DLL
1. Make sure both Certify and ScreenScraper.exe are not running.
2. Go to the …\Worksoft\Certify\Interface Client\Worksoft\Mainframe folder.
3. Copy your ScreenScraper.xml file to ScreenScraperXML.bak
4. Open the ScreenScraper.xml file in Notepad and review the contents.
When you look at the contents of this file, you will note that ScreenScraper.xml is organized in sections for each supported emulator. Each section begins with an "<EMULATOR name={emulator name}>" tag and ends with an </EMULATOR> tag. The selected emulator is specified by the <DEFAULT> tag at the top of the file.
5. Make sure the DEFAULT tag specifies your emalator name.
Example: <DEFAULT name="Attachmate Extra"></DEFAULT> line.
6. Find the EMULATOR section for your Emulator:
Example: Assuming you are using the Attachmate Extra emulator, you would look for the following line:
<EMULATOR name="Attachmate Extra">
7. Change the <DLLNAME> value to the actual name of the WinHLLAPI DLL
Example: <DLLNAME>WHLAPI32.dll</DLLNAME>
8. Change the <DLLPATH> value to point to the actual location of your Reflection installation:
Example: <DLLPATH>C:\Program Files\Reflection</DLLPATH>
9. Make sure the <SESSION> is set to "A"
Example: <SESSION>A</SESSION>
10. Save the file.
11. Go to the location of your WinHLLAPI DLL and re-register it using regsvr32.exe
Example: Assuming our same Attachmate example
a. Open a command prompt
b. Change directory to the Reflection folder:
CD C:\Program Files\Reflection
c. Register the WinHLLAPI DLL
C:\WINDOWS\SYSTEM32\Regsvr32.exe WHLAPI32.DLL
III. Verify that you can Learn a screen using Mainframe Learn (ScreenScraper)
1. Start your Emulator session.
2. Start ScreenScraper.exe and verify that the error messages no longer appear.
If you are still seeing the error messages after following these instructions, please contact your Worksoft Customer Support representative for assistance.