Notes on using EHLLAPI/WinHLLAPI with HostExplorer

--------------------------------------------------

WinHLLAPI
---------

32-Bit Name:

* WHLLAP32.DLL

Requirements:

* Must call WinHLLAPIStartup before placing any calls

* Must call WinHLLAPICleanup after all calls

The WinHLLAPIStartup/WinHLLAPICleanup must be called for *every* thread

that wants to use WinHLLAPI.

If you are writing a VB program and using HLLCALLS.TXT as the interface

layer, please check and use the new file attached.

EHLLAPI
-------

32-Bit Name:

EHLLAP32.DLL

Requirements:

* None to start using the API.

* Should call RESET SYSTEM as last call for every thread using EHLLAPI

If you are writing a VB program and using HLLCALLS.TXT as the interface

layer, change the comments at the top of the file and delete the two functions
EHLLAPIStartup() and EHLLAPICleanup() since they are used only by
WinHLLAPI.

The entry point for 32-Bit HostExplorer EHLLAPI is:

void EXPORT HLLAPI32( LPWORD lpwFunction, LPSTR lpData, LPWORD lpwLength, LPWORD
lpwRetCode )

Auto-Starting Sessions (EHLLAPI and WinHLLAPI)

----------------------------------------------

For both APIs, all you have to do to start a new session is ConnectPS with
the proper session short name. This assumes that you created a profile and
when saving the profile, assigned a session Short Name. The EHLLAPI/WinHLLAPI
interface will automatically start the emulator with the proper profile.

Do *NOT* spawn HOSTEX32.EXE, TN3270.EXE, TNVT.EXE, or TN5250.EXE to start

a new session. let the API do that for you.

MOST IMPORTANT
--------------
DO *NOT* copy any of the HostExplorer DLLs to any other folder on the
system. This will lead to an inability to start the correct session profile.
The proper method is to add HostExplorer to your path statement. Please
check your system to make sure that there exists only ONE copy of the
EHLLAP32.DLL or WHLLAP32.DLL on your system and that it is in the main
HostExplorer folder.

i.e. If you installed HostExplorer on Windows 98 to

C:\Program Files\Hummingbird\Connectivity\13.00\HostExplorer, then add
the following line to the end of your AUTOEXEC.BAT file:

SET PATH=%PATH%;C:\Progra~1\Hummin~1\Connec~1\13.00\Hostex~1

The PATH command above is purely an example. The shortname version of the
full path may not correspond to the above on your system. Verify the
correct shortname version of the path.

If you are on Windows NT, you set the path in Control Panel in the System
applet under the Environment tab.

If you still encounter problems, then please provide a clear description

of what you are trying to do, how you are trying to start the session so that
we can reproduce the problem here.

OIA Strings using EHLLAPI/WinHLLAPI

-----------------------------------

The following messages can appear in the OIA string (returned using
Function 13 CopyOIA with NEWOIA specified).

Offset Text Emulation Description

-----------------------------------------------------------------------

9 "X CLOCK" 3/5 AID Key pressed

9 "X SYSTEM" 3/5 Keyboard Locked - Generic
18 "A" 3/5/V Session Short Name (The PS Shortname is
returned)
53 "^" 3/5/7 Insert Mode
55 "MW" 5 Message Waiting

OIA Strings using OLE Method

----------------------------

The following messages can appear in the OIA string returned from the
Host "OIA" method. i.e. szOIA = CurrentHost.OIA

The following messages can appear in the OIA string (returned using
OLE OIA method).

Column Text Emulation Description

-----------------------------------------------------------------------
8 "X SYSTEM" 3/5 Keyboard Locked - Generic
8 "X Num " 3/5 Keyboard Locked - Numeric Field Only
8 "X PROG756" 3/5 Data Stream Error
8 " PROG505" 3/5 System Not connected
8 "X CLOCK" 3/5 AID Key pressed
8 "X <-�->" 3/5 Go Elsewhere
8 "X -f" 5 Hex Key Indicator
8 "Wait" V (KAM) Keyboard Locked Indicator
18 "A" 3/5/V Session Short Name
20 "VM/370-1" 3/5/V Session Long Name
30 "123.456.789.01x" 3/5/V Gateway or Host IP Address
45 "DIAC" 5 Diacritic Indicator
47 "PRT" V Auto-Print Indicator
48 "HEX" 5 Hex Key Indicator
51 "INS" 3/5/V Insert Indicator
53 "Alt" 3 ALA Alternate Input Mode Indicator
53 "CMP" V COMPOSE Indicator
53 "MW" 5 Message Waiting
53 "APL" 3 APL Indicator
57 "SCRLBACK" V Scroll back enabled
57 "LU123456" 3/5 LU Name or LDEV Address
66 "HOLD" V HOLD Indicator
66 "DOC" 3 Document Assist
69 "\xBB" 3 Word Wrap
71 "#" 3/5 Numeric Field
72 "�" 3/5 Operator Selectable Field
72 "1" V VT 420 page Indicator
74 "rrr-ccc" 3/5/V Row/Col Position Indicator

Notes: Emulation: 3 = 3270, 5 = 5250, V = Unix