Troubleshooting
Problem
This document describes how to use the EHLLAPI programming interface with the emulator provided with the IBM i Access Client Solutions product.
Resolving The Problem
This document describes how to use the EHLLAPI programming interface with the emulator provided with the IBM i Access Client Solutions product.
Applications that were previously written to use industry-standard EHLLAPI and PCSAPI interfaces can also work with the IBM i Access Client Solutions 5250 emulator. Using these interfaces requires some extra setup. This document explains the steps you need to take in order to use EHLLAPI and PCSAPI with IBM i Access Client Solutions.
Note: Starting at IBM i Access Client Solutions 1.1.8.1 when used with the IBM i Access Client Solutions EHLLAPI Bridge 8.18.316 or later code levels the IBM i Access Client Solutions EHLLAPI environment is now supported in a 64-bit Java runtime.
The support documented here is only supported by IBM i Access Client Solutions Version 1.1.6.2 or later.
Step 1 – Install the IBM i Access Client Solutions EHLLAPI Enablement Tool
https://www-01.ibm.com/marketing/iwm/iwm/web/dispatcher.do?source=swg-ia
Sign on with IBM Registered ID, agree to the license agreement and on the Download page select the EHLLAPI package. Download the tool, and run acshllapi.exe to install it. The installation tool uses Windows Installer technology to place the bridge into a default or user-selected location. The default location is C:\Program Files\IBM\EHLLAPI (C:\Program Files (x86)\IBM\EHLLAPI on 64-bit systems).
Note: If multiple emulators are installed, you need to ensure that the directories listed in the previous paragraph are listed first in the Windows "system" environment variable PATH. If they are not, the HOD 5250 emulator attempts to bind to the wrong EHLLAPI module resulting in failures.
If you plan to use the PCSAPI programming interface to start emulator sessions when IBM i Access Client Solutions are not already running, you must take an extra step to ensure the emulator environment is initialized before you attempt to start any sessions by using PCSAPI. Ensure the environment is initialized by launching IBM i Access Client Solutions PCS plug-in.
The following command starts the IBM i Access Client Solutions PCS plug-in as a background task:
START C:\Users\<userprofile>\IBM\ClientSolutions\Start_Programs\Windows_i386-32\acslaunch_win-32.exe /plugin=pcs
Note: This example assumes you are running IBM i Access Client Solutions from the default deployment location of C:\Users\<userprofile>\IBM\ClientSolutions directory. Substitute your actual location for the one shown in this example.
Note:
IBM i Access Client Solutions version 1.1.8.0 and earlier do not support running in 64-bit mode. You must run IBM i Access Client Solutions in a 32-bit JVM. If a 32-bit JRE is installed it can be invoked by using the 32-bit launch program, even on a 64-bit PC.
You can now start emulator sessions programmatically through the PCSAPI interface.
Note: The IBM i Access Client Solutions EHLLAPI support is designed other than the differences mentioned to provide comparable specification support as Personal Communications 6.0. You can link to the Personal Communications 6.0 "Introduction to IBM Standard EHLLAPI, IBM Enhanced EHLAPI, and WinHLLAPI Programming" document here (Personal Communications 6.0 EHLLAPI).
Historical Number
653368666
Was this topic helpful?
Document Information
Modified date:
07 July 2021
UID
nas8N1010639