|Attachmate myEXTRA! Terminal Viewers
HLLAPI Client Release Notes
© 2002 Attachmate Corporation. All rights reserved.
Attachmate Terminal Viewers provides a HLLAPI interface to the Java Viewers to enable you to run an existing Windows-based HLLAPI client application.
For information about the current HLLAPI version of myEXTRA! Terminal Viewers, visit our support website at http://www.supportweb.attachmate.com.
|32-bit Standard EHLLAPI||ehlapi32.dll
|16-bit Standard EHLLAPI||acs3ehap.dll|
For HLLAPI support, the Terminal Viewers require Microsoft Internet Explorer version 5.0 (or later), with the most recent Java VM upgrade available.
The latest versions of these are available at the following Web sites:
Microsoft Internet Explorer - http://www.microsoft.com/windows/ie
Microsoft Java VM Updates - http://www.microsoft.com/java
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|
|You must re-start your computer after installation is complete.|
|To use your HLLAPI application with a Terminal Viewers session|
The HLLAPI short name appears at the bottom of the display on the status line.
|Your System Administrator specifies which configurations assigned to you will support HLLAPI, and whether the "session short-name" (used by HLLAPI to identify a particular session) is a specific letter, or the first available letter.|
back to top
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/2000|
...where path is the HLLAPI Client Components directory. The path must be entered using short directory names, such as:
You can also verify that HLLAPI support is enabled if the short session name is visible on the status line.
Make certain that the HLLAPI client components directory is part of the system PATH environment variable. To do so, you must edit the system.ini file.
|To edit the configuration for Windows 98|
...where path is the HLLAPI Client Components directory. The path must be entered using short directory names, as described in the procedure for editing the configuration for Windows NT/2000.
Before starting your DOS-HLLAPI application in Windows 98
Once you have edited the configuration and re-started Windows, you must launch the HLL95.exe program before starting your DOS-HLLAPI application.
|To launch the HLL95.exe program|
A small icon shaped like a computer monitor appears on the left side of the taskbar.
back to top
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|
You should see a thread named HLLAPI-A, HLLAPI-B, and so forth.
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.
back to top
|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.|
|Sometimes the terminal window must be re-sized before the session name appears.|
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.|
back to top