Configuring BlueZone to work with an existing 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 external HLLAPI application is really the key to making it work with BlueZone.

Note: This procedure is provided as a quick reference for configuring BlueZone to work with a HLLAPI application. The BlueZone Desktop Administrator's Guide contains more detailed information on this subject. If you are a BlueZone administrator, we recommend that you read "HLLAPI support" and related topics in Chapter 3, Configuring BlueZone, of the BlueZone Desktop Administrator's Guide.
There are a few things you must know and do in order for BlueZone to work properly:
  • In your HLLAPI application, is there a way you can change the name and the location (path) of the HLLAPI program used by your emulator?

    No: If not, you must re-name the BlueZone HLLAPI DLL and manually copy it to the location where your HLLAPI application is expecting to find it. You may already have a HLLAPI DLL in this location. If you do, temporarily re-name it so that you do not over write it with the BlueZone DLL.

    Yes: Launch the Configuration Interface of your HLLAPI application and change the name and location of the HLLAPI DLL to that used by BlueZone. The BlueZone 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

  • Is there a HLLAPI.DLL from a competitor's product installed on the same workstation that you are using to test the BlueZone HLLAPI interface?

    Yes: If so, you may have to temporarily rename that DLL while testing BlueZone to prevent conflicts.

    No: Proceed to BlueZone Configuration after BlueZone Desktop is installed, and launch a BlueZone Display session.

Follow the steps below to configure BlueZone:

  1. On the BlueZone menu bar, click Options API.
    The API Properties dialog opens.
  2. Check the Enable DDE Server Interface check box.
    BlueZone is now listening for a DDE connection.
  3. Run the HLLAPI application and check to see if it connects to BlueZone.