HostExplorerTM

Release Notes V8.0


Contents

New Features

HostExplorer
HostExplorer Deployment Wizard
Hummingbird Connectivity SSL
SOCKS
Sconfig

Discontinued Features

All Applications
HostExplorer
Jconfig

Known Issues

General
Hummingbird Basic Language
Web Update
Windows Installer
HostExplorer
HostExplorer Deployment Wizard

Documentation Updates

HostExplorer Documentation

Documentation Set

Release Notes
Manuals
Help

Third Party Software

Adobe Acrobat Reader
MIT Kerberos

Contacting Hummingbird



New Features

This section describes the new features available for HostExplorer 8.0 and HostExplorer Deployment Wizard 8.0. For information on the features added in previous releases, contact your Hummingbird sales representative.

Microsoft Windows 2000 Certification

HostExplorer is certified for Microsoft Windows 2000.

Enhanced "All Users" Installation

For Windows NT/2000/XP platforms, Hummingbird Setup Wizard prompts you to choose between installing the product on the computer for the currently logged in user, or for all users. If you select "All Users", user profile folders are created for each user who logs into the workstation. When a user launches the Hummingbird product for the first time, the folders and files within the Default User directory (the Hummingbird product directory under the Program Files folder) are automatically and transparently copied to the user's profile folder.

Note:  You have the option of customizing the Default User directory tree that is copied to the user's profile folder by adding user files such as profile or keyboard files.


The individual user profile folders allow users to maintain their own personalized Hummingbird settings on a workstation, preventing several users who log into the same workstation from overwriting each other's profiles and settings with their own preferences.

System Administration

The System Administration folder is now called Product Administration.


HostExplorer

Connecting to Available Hosts

The Connection folder of the Session Profile dialog box now lets you specify a list of hosts that HostExplorer will use to automatically connect to an available host in the event that one of the hosts becomes unavailable. The dialog box also lets you specify properties such as the number of times HostExplorer will attempt to connect to the list of hosts or the number of seconds between each connection attempt.

Informative Connection Messages

When there is a delay in connecting to a host, messages related to the connection now appear providing you with more information such as the address of the host, the reason for being unable to connect to a host, and the delay before the next connection retry.

Displaying Host Response Time

Using the Display folder of the Session Profile dialog box, you can now indicate if you want HostExplorer to display the amount of time that elapsed before HostExplorer received responses from the host. This response time appears in the operator information area (OIA) of the HostExplorer session window.

Working with Layouts of HostExplorer Sessions

If you tend to work with multiple HostExplorer sessions at one time, you can save this working environment as a "layout" so that you can re-use it later. For example, if you often work with four specific sessions placed at certain positions on the computer screen, you can save this working environment as a layout. The next time you open this layout, the same four sessions will appear in the exact positions and size in which you saved them in the layout.

Managing Session Events

The Event Handler is a powerful tool that enables HostExplorer to automatically react to certain events such as a specific time of day, when a connection is made, and when the cursor enters a field position. In the Event folder of the Session Profile dialog box, you can specify conditions that will trigger actions (for example, Quick Scripts, macros, and system commands) automatically when these conditions are met. For example, you can set a new condition so that at 9:00 a.m. each day, HostExplorer runs a macro that starts a new session and automatically logs you in to the host.

Revamped User Interface

In this version, the session options in the Session Profile dialog box have been re-organized and revised to provide you with easier accessibility to the numerous HostExplorer settings.

Additional Hotspot Options

In the Hotspot folder of the Session Profile dialog box, you can make your hotspots appear invisible; that is, rather than the hotspot text/region being highlighted, it will appear in its regular display but when you place your cursor over the hotspot, the cursor will change to a hand and you can click the hotspot to activate it. In addition, you can choose between activating the hotspot through a single mouse click or a double mouse click.

Cross-Hair Cursor

On the View menu of the HostExplorer session window is a new item which increases the visibility of the cross-hair cursor. A cross-hair cursor consists of two "cross-hair" lines that span across the screen and intersect at the cursor.

Enhanced Color Mapping

HostExplorer provides an option in the Color folder of the Session Profile dialog box that lets you automatically assign a uniform background and/or foreground color to all field types (for example, bold, underline, and blinking) in the host session.

Enhanced File Transfer Translation Tables

HostExplorer now provides you with a larger number of PC code pages to choose from. These PC code pages are translated to the host code page that you selected in the Character Set category of the Terminal folder in the Session Profile dialog box. As well, HostExplorer automatically displays the most adequate PC code pages for the file transfer based on the host code page that you chose.
In addition, you can create your own custom transfer table in which you can define translation settings that will be used to translate data between the host and the PC.

Printing Using Printer Sessions

PrintExplorer functionality is now fully embedded in HostExplorer. You can create printer session profiles that are used to print information from host computers to any LAN printer in your enterprise network. The host computers can be either IBM mainframe (3270) or IBM AS/400 (5250) midrange computers. You can associate a printer session profile with a display session profile so that when you connect to a host using the display session profile, the printer session profile starts automatically and prints the data.

Printing Multiple Screens

In addition to printing individual host screens, HostExplorer provides a feature that enables you to capture multiple screens while navigating through your application so that you can print all of the screens at once.

Printing to a File

For VT profiles, HostExplorer provides a new option that lets you automatically send print jobs to a specified file. You can specify whether you want a single file to host each print job (by either overwriting the existing file or appending to the existing file) or if you want new files to be generated with incremental file names.

Support for SSL/TLS

HostExplorer 8.0 and HostExplorer Deployment Wizard 8.0 now support Secure Socket Layer (SSL)/Transport Layer Security (TLS) encryption protocols. This allows administrators and users to specify various security options such as the SSL/TLS protocol that they want to use and the cipher suite. The Certificate Manager, a new HostExplorer component, enables management of server certificates, user certificates, as well as self-signed certificates. It also enables you to manage your certificate data store, import Windows certificates, and create new certificates and private keys. The HostExplorer SSL/TLS implementation is based on the Open SSL project libraries. The OpenSSL project is a collaborative effort to develop a robust, commercial-grade Open Source toolkit, implementing the SSL (versions 2 or 3) and TLS (version 1) protocols, as well as a full-strength general-purpose cryptography library. You can access the OpenSSL project at the following web site:

http://www.openssl.org

Redirecting Data Using Proxy Server

HostExplorer now provides Proxy Server, a tool that enables administrators to redirect data coming in from a range of IP addresses and ports to a specific host and port. You can administer the Proxy Server from the Proxy Server Console. This service is particularly useful when using web-deployed profiles from an extranet. In a traditional environment, administrators must open their firewall to their enterprise hosts to allow users to connect to them from the outside. With the Proxy Server, administrators simply need to open their firewall to the server on which the proxy server resides. Users will, then, connect to the proxy server which will deliver their connections to the desired host.

New API Functions

A number of new functions have been included in the Component Object Model (COM) APIs.

IBM HLLAPI Compatibility

HostExplorer now offers full compatibility with IBM HLLAPI. Therefore, any organization can migrate its HLLAPI applications from IBM Personal Communication (PCOM) to HostExplorer without any programming change whatsoever.

Converting Macros Using Macro and Profile Converter

Corporations that migrate from IBM PCOM now can convert their existing macros to HostExplorer macros with the Macro and Profile Converter. This tool already enables administrators to convert Rumba and Attachmate macros and profiles to HostExplorer macros and profiles.

Support for GSS-API in FTP for Windows Explorer

You can now connect to your FTP server using the Generic Security Service API (GSS-API), which is an API for distributed security services. This API can handle session communication securely, including authentication, data integrity, and data confidentiality. The GSS-API is designed to insulate its users from the specifics of underlying mechanisms. The GSS-API implementations have been constructed based on a range of secret-key and public-key technologies (including Kerberos).

New Support for FTP Quick Scripts

Quick Script Editor, a graphical development environment, now provides support for FTP Quick Scripts which you can use to automate repetitive and tedious tasks such as uploading files to the server at a certain time each day.


HostExplorer Deployment Wizard

Web Browser Support

In addition to Internet Explorer V5.0 (and higher), web-deployed HostExplorer sessions can now run seamlessly on Netscape V4.79.

Co-Existence with HostExplorer Installation

End users who already have version 8.0 of HostExplorer installed on their machines can access a web-deployed HostExplorer session on the same machine.

New Deployment Packager Tool

The Deployment Packager tool, available with the HostExplorer Deployment Wizard product, lets you package auxiliary files and applications to be deployed along with HostExplorer profiles. The tool does this by letting you create and edit Package Assemblies (.dpa files) which will be later built as package (.dpf) files. The Package Assemblies describe the contents of package files, as well as where the packages will be installed on the users' machines. In the Deployment Wizard, you can specify these custom assembly files that you have created, as well as package files that were previously generated or given to you. The Deployment Runtime component can generate these assemblies into packages and deploy them (as well as existing packages) to the remote desktops.

Customizing Deployment Actions

In the HostExplorer Deployment Wizard, you can define actions—running a program or deploying packages—and assign these actions to certain conditions. For example, you can use the wizard to make sure that a specific package is deployed after the user downloads the web-deployable installation of HostExplorer; alternatively you can run a specific program before an upgrade of HostExplorer.

Deploying Printer Session Profiles

HostExplorer Deployment Wizard now provides full support for printer session profiles. Printer session profiles that you create in HostExplorer can be deployed and executed on a client machine using the Deployment Runtime Component.

Hiding Toolbar and Menu

The Deployment Wizard provides options that enable administrators to specify the automatic removal of the web browser toolbar and menu when users launch a session on their workstations.

Saving Shortcuts

You now have the option of saving deployed HostExplorer sessions as shortcuts. By default, the shortcut is saved to your desktop.


Hummingbird Connectivity SSL

Hummingbird Connectivity SSL enables HostExplorer to provide Secure Socket Layer (SSL) encryption, authentication, and privacy to network communication over Telnet. Hummingbird Connectivity SSL is a free add-on for HostExplorer that contains the necessary cryptographic libraries for SSL/TLS. You can download this application from the Hummingbird web site in the connectivity product pages:

http://www.hummingbird.com

For information on how to install Hummingbird Connectivity SSL, see the Hummingbird Connectivity SSL Release Notes.


SOCKS

New Hummingbird SOCKS Client Configuration Wizard

The Hummingbird SOCKS Client Configuration wizard lets you configure SOCKS and set the SOCKS server authentication settings from a user interface. Using the wizard, you can make all your configurations in the socks.cfg file without editing the file manually.


Sconfig

New Custom Folders Option

Sconfig now lets you create new custom folders and subfolders and add them to the directory structure.

Run Sconfig from a Command Line

You can now use a command line to run Sconfig, generate a transform file (.mst), and apply it to an .msi file.


Discontinued Features


All Applications

Windows 95 Support

Hummingbird Connectivity V8.0 products no longer support Windows 95.


HostExplorer

This section lists and describes features that have been discontinued for HostExplorer 8.0.

Accessories Applications

The following Accessories have been discontinued:

PrintExplorer

The PrintExplorer functionality is now available through HostExplorer printer sessions. For more information, see Printing Using Printer Sessions.


Jconfig

Jconfig, the Hummingbird remote configuration tool, has been discontinued.


Known Issues

This section describes issues that Hummingbird is aware of at the time of release.


General

Issues with MIT Kerberos for Windows Client 2.1 and 2.0 in a Windows TSE Environment

You may experience problems with MIT Kerberos for Windows Client 2.0 and 2.1 in a Windows TSE environment (Windows NT 4.0 Server Terminal Server Edition or Windows 2000 Server with Terminal Services). When MIT Kerberos Client 2.0 or 2.1 Setup tries to install configuration files into the Windows or Windows\System32 directories, Windows TSE installs them into user profile directories instead, without adding the new path to the system path. As a result, the application cannot access the required files.

To solve this problem:

  1. To the system path variable, add the path to the user profile folder:
  2. If the user profile folder is on an NTFS partition, grant full permissions to all users for this folder.


Hummingbird Basic Language

Migrating Script Files from Version 6.2/7.x to Version 8

Most compiled Hummingbird Basic files (*.ebx) work in version 7.x/8.x without requiring you to rebuild them in Hummingbird Basic Workbench. In some cases, the migrated script does not work if the script used to create the .ebx file used one or more of the Hummingbird directory macros (-e, -h, or -u). In this case, the script must be rebuilt to work with version 7.x/8.x.
Hummingbird Basic expands these macros in the following manner:
Macro Expands to path:

-h

C:\Program Files\Hummingbird\Connectivity\
version\Accessories\

-u

ApplicationDataFolder\Hummingbird\Connectivity\
version\Accessories\

-e

ApplicationDataFolder\Hummingbird\Connectivity\
version\Accessories\EB\


In version 6.2, the expansion was essentially the same, except that all binary files for the product were accessible from the directory. For version 7, only the binary files for the installed features of Accessories are located in the directory.


Web Update

Update Hummingbird Option Visible to Non-Administrators

Non-administrators will see the Update Hummingbird option and the WebUpdate Settings icons in the Product Administration folder. Depending on your platform, this option behaves differently:

Windows Platforms

When a non-administrator double-clicks either icon, the Hummingbird update web site opens in a browser, but WebUpdate.exe does not run.

Windows Terminal Server Platforms

When a non-administrator double-clicks either icon, a message appears advising that, to perform an update, you must contact a system administrator. Only an administrator can use the shortcuts.


Windows Installer

The following are known Windows Installer issues:
    1. Advertised shortcuts are different from conventional shortcuts. Advertised shortcuts contain Windows Installer information about the product and feature. When multiple products install the same shortcut, only the last product is registered with the shortcut. Uninstalling that product removes the shortcut. However, it is easily recreated by selecting the Repair option (in Program Maintenance) for one of the remaining products.
For more information, see "Updating the Personal User Directory for All Users" in "Chapter 3: Advanced Installation" of the product manual.

Installing a Product without Advertised Shortcuts

Option 1

For each installation, run Setup using the following syntax:

setup /v"DISABLEADVTSHORTCUTS=1"

Option 2

For multiple installations or in the case of a multi-user rollout:
  1. Run Sconfig.exe.
If Sconfig is not installed, run the English version directly from the CD or from a network image. To launch Sconfig, browse to the folder:

Program Files\Hummingbird\Connectivity\8.00\Accessories

  1. Select the product .msi from the CD or network image.
  2. In the Properties dialog box, add the property DISABLEADVTSHORTCUTS. Set the value of this property to 1.
  3. Create the transform file in a location where you have write access.
  4. When you install the product, apply the transform you have just saved. This transform forces Windows Installer to create non-Advertised shortcuts.

Disabling Migration

To preserve an existing product version and install the new version 8.0 side-by-side, you may want to disable migration.

Note:  Side-by-side installation is not possible for all version 8.0 products (that is, version 8.0 products cannot co-exist with most other version 8.0 products).

Warning: Side-by-side installation is not advised. It may cause incompatibilities (especially with the NFS Maestro product line).


To disable migration of user profiles from version 6.2 to 8.0, run:

setup /v"ALLOWMIGRATE="

To disable migration of user profiles from version 7 to 8.0, run:

setup /v"DISABLEMAJORUPGRADE=1"


HostExplorer

Different Behavior Between Kerberos Client Versions Regarding Tickets

During FTP sessions, Kerberos for Windows v2.0 client does not store service tickets in the Kerberos cache. However, Kerberos for Windows v2.1 and v2.1.1 clients place service tickets in the cache. Therefore, any new connection to the host will result in new tickets being generated. For example, if there are lengthy FTP sessions running with connections to numerous hosts, there could be cache sizes of 1,000 tickets, resulting in performance problems. This is a known issue with the Kerberos for Windows client software.

Support of Kerberos Tickets on Windows XP

MIT Kerberos Client 2.1 (Leash32) does not support Kerberos version 4 tickets on Windows XP. To enable support of Kerberos version 4 tickets, browse to the leash32.exe file. Right-click the file and click Properties. On the Compatibility page, select Windows 98/Windows Me compatibility.

Note:  Windows XP supports only the Kerberos for Windows 2.1.1 client.


OpenSSL

HostExplorer interfaces to the OpenSSL Project for SSL/TLS support and requires the following DLLs: ssleay32.dll and libeay32.dll. You have the option of building your own DLLs using the OpenSSL source code or you can obtain the DLLs supplied by Hummingbird in the Hummingbird Connectivity SSL add-on. If you build your own OpenSSL DLLs, you must build them directly and completely from the OpenSSL release for them to work properly with HostExplorer. Do not attempt to remove routines from these libraries for any reason (for example, to reduce library sizes); otherwise, a General Protection Fault (GPF) might result with libraries that are not complete. If you encounter system problems, use the DLLs provided in the Hummingbird Connectivity SSL add-on. The add-on is available on the product CD or at the following Hummingbird web site:

http://www.hummingbird.com

To build OpenSSL DLLs:

  1. Obtain the latest distribution of the OpenSSL Project at the following web site: http://www.openssl.org/.

    Note:  Before building the OpenSSL DLLs, make sure that Perl is already installed.

  2. Read the file install.w32 which provides detailed build information for Windows and follow the configuration steps.
  3. In the command line, type the following

    cd InstalledPath\OpenSSL

where InstalledPath is the path where OpenSSL is installed.
  1. Enter the following command, as described in the install.w32 document:

    nmake -f ms\ntdll.mak

  2. To test the build, enter the following commands:

    cd out32dll

    ..\ms\test

Take note of the following:
Therefore, the assembly languages were not used. To configure the makefiles for those language files, you should run either the ms\do_masm or ms\do_nasm tool. You do not need to execute the Perl Configure script again.

Recording Quick Scripts with SSL/TLS Enabled

If you want to run a Quick Script with SSL/TLS enabled, make sure that the script includes a Connect command at the beginning; that is, the Quick Script is recorded prior to the connection. Otherwise, it will appear that the Quick Script has started before the connection to the host has been established.
As a result of the high overhead of public key cryptography and SSL/TLS handshaking, there is a delay between the black screen and the host logo. Often, the script will run ahead and attempt to issue a command before the connection is established, thus breaking the protocol.


HostExplorer Deployment Wizard

Deployed Session Cannot Co-Exist with HostExplorer Version 7.x

You cannot access a deployed HostExplorer session if version 7.x of HostExplorer is already installed on the same machine. However, you can access a deployed session if version 6.2 or 8.0 of HostExplorer is already installed on your machine.

Note:  While Internet Explorer warns you about the lack of co-existence with version 7.x of HostExplorer, the Netscape browser does not.


No Spaces Allowed in Project Names When Using Netscape

If you are launching a web-deployed HostExplorer session in the Netscape web browser, make sure that the Deployment Project name contains no spaces.

Running Multiple Versions of Deployed HostExplorer Sessions

You cannot simultaneously run multiple versions (that is, versions 7.x and 8.0) of deployed HostExplorer sessions on the same machine. If you want to run different versions of the deployed sessions, make sure that you uninstall Hummingbird HostExplorer Web Deployment (version 8.0) or Hummingbird HostExplorer ActiveX (version 7.x) before running the other version of the deployed session.

Uninstalling Web Deployment

If you run a deployed HostExplorer session on a machine that does not have HostExplorer installed, but later want to install HostExplorer, you must first uninstall HostExplorer Web Deployment. If required, you can run a deployed HostExplorer session again after the HostExplorer installation is completed.
If you have HostExplorer and the Deployment Wizard installed on the same machine and you launch a deployed session from that machine, you must uninstall HostExplorer Web Deployment before you uninstall HostExplorer.
If you run a deployed HostExplorer session on a PC that has a version of Internet Explorer that is less than V4.01 (with Service Pack 2), and you want to uninstall HostExplorer Web Deployment, you must install the 50comupd.exe update from Microsoft. This is especially important for machines running on Windows NT 4.0. You can download the file from Microsoft at the following URL, and click the link Download 50comupd.exe (x86):

http://www.microsoft.com/msdownload/ieplatform/ie/comctrlx86.asp

Alternatively, the administrator can create a deployment package that contains the 50comupd.exe file and deploy it so that the end users can access it. For information on deploying packages, refer to the Deployment Packager Help and HostExplorer Deployment Wizard Help.


Documentation Updates


HostExplorer Documentation

A draft HostExplorer Programming Guide is available in WinHelp and PDF format. For the most recent version of the documentation, contact Technical Support or visit the Hummingbird web site:

http://www.hummingbird.com


Documentation Set

The following documentation is provided with your Hummingbird product.


Release Notes

Release Notes are available in hard copy and HTML format. The HTML version is automatically installed when you install the product.


Manuals

Hummingbird manuals contain conceptual information on your product; procedural information on installing and using the product and related applications; and some manuals contain programming reference, interface reference, and troubleshooting information.
Manuals are available in print and online. The online versions are installed only if you do a Complete installation. Otherwise, you can locate them on the product CD in the following path:

cddrive:\Manuals

For a list of manuals that come with your product, see the introductory chapter of your Hummingbird product manual.


Help

The online Help is a comprehensive, context-sensitive collection of information regarding your Hummingbird product. It contains conceptual and reference information, and detailed, step-by-step procedures to assist you in completing your tasks.


Third Party Software

The following software is required for some components. You can install all third party software (except for MIT Kerberos, see below) from Hummingbird Master Setup (msetup.exe).


Adobe Acrobat Reader

Online manuals are available in Adobe Acrobat 4.0 PDF format. You can use the supplied Adobe Acrobat Reader version 5 to view, navigate, and print these manuals.
The Reader for Windows is located on the CD in the following path:
cddrive:\3rdParty\Acrobat


MIT Kerberos

Kerberos is a network authentication protocol that provides the necessary network tools to secure information systems across an enterprise. Based on client/server identification, Kerberos uses a key-distribution model and a secure password to restrict access to classified accounts.
To use Kerberos support for HostExplorer, NFS Maestro Client, NFS Maestro Solo, or NFS Maestro Server, you must install the Kerberos software from MIT. To download the latest version of Kerberos, go to the following web site:

http://web.mit.edu/network/kerberos-form.html

For information about Kerberos security, go to the following web site:

http://web.mit.edu/kerberos/www/


Contacting Hummingbird

You can contact Hummingbird's Technical Support Department Monday to Friday between 8:00 a.m. and 8:00 p.m. Eastern Time.
Hummingbird Ltd. 1 Sparks Avenue, North York, Ontario, Canada M2H 2W1

Canada and the USA

International

Technical Support:

1-800-486-0095

+1-416-496-2200

General Enquiry:

1-877-FLY-HUMM

+1-416-496-2200

Main:

+1-416-496-2200

Fax:

+1-416-496-2207

E-mail:

support@hummingbird.com

FTP:

ftp.hummingbird.com

Online Request Form:

www.hummingbird.com/support/nc/request.html

Web Site:

www.hummingbird.com/about/contact.html