|Attachmate EXTRA! Terminal Viewers HLLAPI Client
© 2005 Attachmate Corporation. All rights reserved.
EXTRA! Terminal Viewers from Attachmate provides a HLLAPI interface to the Java Viewers to enable you to run an existing Windows-based HLLAPI client application.
|32-bit Standard EHLLAPI||ehlapi32.dll
|16-bit Standard EHLLAPI||acs3ehap.dll|
For HLLAPI support, the Terminal Viewers require Microsoft Internet Explorer version 6.x (or later), with the most recent Microsoft Java VM upgrade available.
Before running any HLLAPI-enabled configurations from the Terminal Viewers, you must install the HLLAPI components needed to run HLLAPI-enabled Terminal Viewers sessions.
|To install the HLLAPI Client Components|
|To use your HLLAPI application with a Terminal Viewers session|
If you are using DOS-based HLLAPI applications with Terminal Viewers, additional configuration of your system is necessary. Choose the procedure appropriate to the version of Windows you are using.
The HLLAPI Client Components directory must be part of the system PATH environment variable. To do so, you must edit the config.nt file.
|To edit the configuration for Windows NT/Windows 2000|
The HLLAPI Client Components directory must be part of the system PATH environment variable. To do so, you must edit the system.ini file.
|To edit the configuration for Windows 98|
Before starting your DOS-HLLAPI application in Windows 98
Once you have edited the configuration and re-started Windows, you must start the HLL95.exe program before starting your DOS-HLLAPI application.
|To start the HLL95.exe program|
Function 104: Query/Set Window Status
Terminal Viewers HLLAPI supports the use of function 104, Query/Set Window Status to show/hide/minimize a session.
For more information on this and other HLLAPI functions, see the Attachmate EHLLAPI Language Reference, which is distributed with the EXTRA! Developer Series API SDK.
Verifying HLLAPI Support
In Microsoft Internet Explorer, in the Java Console, you can verify that HLLAPI support is enabled for a session.
|To verify that HLLAPI support is enabled|
WinHLLAPIStartup and WinHLLAPICleanup Functions
In addition to the standard WinHLLAPI entry point, WinHLLAPIStartup and WinHLLAPICleanup functions are supported.
Calls Fail when Session is Closed
When you close a session to which a HLLAPI client application is currently connected, Terminal Viewers HLLAPI sessions are released immediately and subsequent HLLAPI calls fail.
Terminal Viewers Session Must be Launched First
It is necessary to launch a HLLAPI-enabled Terminal Viewers session before attempting to use your HLLAPI application. The HLLAPI function, ConnectmyAccess Linkspace, will return 1 (INVALIDPSID) if the requested session has not been opened first.
Session Parameter WRITE Client Threads
Session parameters WRITE_SUPER (default), WRITE_READ, and WRITE_NONE allow only one client thread to be HLLAPI-connected. Parameters SUPER_WRITE and WRITE_WRITE allow multiple client threads to connect to a single session.
|Attachmate recommends that System Administrators use the Auto Name setting when creating viewer configurations, so that each HLLAPI-enabled session that is launched is given the first available letter name, up to a maximum of 26.|
|You may need to re-size the terminal window for the session name to appear.|
To aid troubleshooting, you can create a log of HLLAPI function calls.
|To create a log file|
|It is important to remove or delete the log file when logging is no longer desired; otherwise it will continue to grow in size each time you run your HLLAPI applications.|