HLLAPI configuration
There are three types of third-party HLLAPI applications that are supported by BlueZone:
•  Windows 32-bit HLLAPI Application
•  Windows 16-bit HLLAPI Application
•  DOS HLLAPI Application
Configuring BlueZone to work with a third party HLLAPI application is really quite simple. Your knowledge of, and your ability to change the configuration of your HLLAPI application is really the key to making it work with BlueZone.
Requirements
To configure BlueZone to interact with a third party HLLAPI application, you will need a Windows workstation with the HLLAPI application properly installed and BlueZone Desktop installed as follows:
BlueZone installation requirements:
1. To enable the BlueZone InstallShield Wizard to add BlueZone to your Windows Path, you must change a setting in the SETUP.INI file. This means that you can not install BlueZone from the CD-ROM. You must copy the entire BlueZone Desktop folder to a folder on your hard drive so that you can edit the SETUP.INI file.
2. Once this has been accomplished, locate and edit the SETUP.INI file with Notepad.
3. Change the following setting from No to Yes, in the SETUP.INI file before installing BlueZone:
[BZSetup]
SetPath=Yes
During installation the BlueZone Setup program will add the BlueZone Program Directory to the Windows “Path Environment Variable” if the workstation Windows 2000, Windows XP, or Windows Vista.
Note
This change requires a system re-boot to take effect.
4. By default, the HLLAPI component is automatically selected to be installed with BlueZone. Verify that the HLLAPI component is selected for installation.
5. Follow the InstallShield Wizard to complete the installation.
HLLAPI application requirements:
There are a few things you must know and do in order for BlueZone to work properly with your HLLAPI application. All HLLAPI applications need to know the name and location of your emulator’s HLLAPI DLL. Specifically, BlueZone's HLLAPI DLL.
1. Does your HLLAPI application, have a way to change the name and the location (path) of your emulator’s HLLAPI DLL?
No - If not, you will have to re-name the BlueZone HLLAPI DLL and manually copy it to the location where your HLLAPI application is expecting to find it. Chances are you already have a HLLAPI DLL in this location that is used by your current emulator. Temporarily rename the DLL so that you do not over write it with the BlueZone DLL. Proceed to question 2.
Yes - Launch the Configuration Interface of your HLLAPI application and change the name and location of the HLLAPI DLL to point to the BlueZone HLLAPI DLL (WHLLAPI.DLL). Proceed to question 2.
BlueZone's HLLAPI DLL is called WHLLAPI.DLL and can be found in the main BlueZone installation directory. The default installation directory for BlueZone is C:\Program Files\BlueZone.
2. Is there a HLLAPI.DLL from a competitor's emulator already installed on the same workstation that you are using to test BlueZone's HLLAPI interface?
Yes - If so, you will have to temporarily rename that DLL while testing BlueZone to prevent conflicts, then proceed to question 3. Or, it might be easier to install and test BlueZone on a workstation that does not have a competitor's emulator installed. Conflicts with existing emulators is a common problem when tying to configure BlueZone to work with a HLLAPI application.
No – Proceed to question 3.
3. Is your HLLAPI application a Windows 32-bit application, a Windows 16-bit application, or a DOS application?
Windows 32-bit - Proceed to the Windows 32-bit HLLAPI Application section.
Windows 16-bit - Proceed to the Windows 16-bit HLLAPI Application section.
DOS on Windows 95/98/ME - Proceed to the DOS HLLAPI Application - Windows 95/98/ME section.
DOS on Windows 2000/XP - Proceed to the DOS HLLAPI Application - Windows 2000/XP section.