Run tests on terminal emulators (Windows only)


LeanFT can test terminal emulator applications that support HLLAPI (High Level Language Application Programming Interface) as well as those that do not, for example, emulator sessions configured to work with the VT100 protocol (using Text-only mode). HLLAPI allows a PC application to communicate with a mainframe application with extended capabilities.

When testing, LeanFT distinguishes between the window of the terminal emulator and the screens in the host application. The terminal emulator window consists of the frame, menus, toolbar, and status bar of the terminal emulator itself. This window remains constant throughout each terminal emulator session.

The terminal emulator screen refers to the area of the window in which the application is displayed. Each time the host responds to user input to the application, the screen changes.

The Terminal Emulator Add-in includes preconfigured settings for several terminal emulators. The Terminal Emulator Add-in also enables you to configure the settings for most other terminal emulators.

Back to top

Before you start: Set up your terminal emulator

On the machine where LeanFT is installed, install and configure the terminal emulator you will be working with.

For a full list of supported terminal emulators, see the LeanFT Product Availability Matrix.

For configuration details for the supported emulators, see Configure an emulator to work with LeanFT.

Back to top

Setting up LeanFT to work with the terminal emulator

To set up LeanFT to work with your terminal emulator:

  1. Ensure that the LeanFT runtime engine is up and running.
  2. From LeanFT icon () on the system tray, open the LeanFT runtime engine Settings dialog box.
  3. On the Engine tab, under Add-ins, select Terminal emulators.
  4. Provide your terminal emulator details:

    1. Run <LeanFT Installation>\bin\TeConfigurator.exe.
    2. In the dialog box that opens, do one of the following:

      • Select a preconfigured terminal emulator from the list. See also Copy existing terminal emulator configurations.

      • Click Open wizard and follow the onscreen instructions to add or modify a terminal emulator configuration.

        Note: On the last page of the wizard there is an option to save the configuration. Use this option if you want, for example, to copy the configuration to another computer.

        By default, the configuration file (.reg) is saved in the <LeanFT installation>\dat folder.

        Then refresh the emulator list (close and reopen the dialog box) and select the new/modified emulator configuration.

    3. (Optional) Under Screen label, define the area of the emulator screen to be displayed.
    4. (Optional) Click Adjust configuration to fine-tune the settings of the emulator that you have selected.
  5. Click OK to save the configuration.

  6. Restart the runtime engine.

Back to top

Supported test objects

The following Terminal Emulator test objects are supported:

Test Object Description

A terminal emulator field that fully supports HLLAPI

TeScreen A terminal emulator screen that fully supports HLLAPI

A terminal emulator screen that uses text-only HLLAPI or does not support HLLAPI


A terminal emulator window

For more details, see the Java SDK Reference, .NET SDK Reference, or JavaScript SDK Reference.

Back to top