Terminal Emulator Pane (Options Dialog Box > GUI Testing Tab)

This pane enables you to change your terminal emulator settings and to validate your current terminal emulator configurations.

To access
  1. Do one of the following:

    • Ensure that a GUI test, action, or component is in focus in the document pane.
    • In the Solution Explorer, select a GUI test or component node or one of its child nodes.
  2. Select Tools > Options > GUI Testing tab > Terminal Emulator node.
Important information

This pane is available only when the UFT Terminal Emulator Add-in is installed and loaded.

Any changes you make to the settings in this pane are immediately applied to the currently open test or business component when you click OK.

Terminal Emulator area: You can select an emulator to test using the Vendor and Emulator list boxes. The displayed lists include all of the vendor/emulator combination settings that are:

  • Preconfigured (supplied with your Terminal Emulator Add-in)
  • Copied to your computer
  • Previously configured using the Terminal Emulator Configuration Wizard

You can also open the wizard to configure a new terminal emulator setting or modify an existing setting.

The Restore Factory Defaults button resets all Options dialog box options to their defaults.

Relevant tasks

Check the validity of a Terminal Emulator configuration

User interface elements are described below:

UI Elements

Description

Vendor

The list of available terminal emulator vendors. Select the vendor for your emulator.

Emulator

The list of terminal emulators available for the selected vendor. Select the emulator application you want to test.

Protocol

The protocol that your emulator uses.

Recommended: Auto-detect

Validate

Validates the current configurations of the selected emulator, and, if an error is detected, displays a brief description that error.

Errors may result from:

  • invalid terminal emulator configurations in the Terminal Emulator pane (Tools > Options > GUI Testing tab > Terminal Emulator node).
  • invalid configurations made when configuring the terminal emulator using the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).
  • errors in the terminal emulator itself.

For a list of possible error responses, see Validating a terminal emulator possible error responses.

Troubleshoot

Opens a specific Help page that provides a troubleshooting solution where available.

Available only if an error response is displayed after you click Validate.

For details, see Validating a terminal emulator possible error responses.

Screen Label

The area from which UFT reads the label property of the emulator screen while recording a test or business component. If the location and length of the label are correctly defined, UFT uses this value as the name of the TeScreen object. The Screen label area is enabled only for emulators that support HLLAPI.

To set the screen label:

Enter the Start row and Start column coordinates that mark the beginning of the emulator label. Define the size of the label by entering the Length (in characters).

You can change the way that UFT reads the label property of the emulator screen, by adjusting the configuration settings. For details, see Manage terminal emulator configuration settings.

Open Wizard

Opens the Terminal Emulator Configuration Wizard. The wizard enables you to define new settings for a terminal emulator or to modify existing user-defined settings. For details, see Terminal Emulator Configuration Wizard Overview.

Adjust Configuration

Opens the Terminal Emulator Configuration Adjustments Dialog Box to allow changes to existing configuration settings in exceptional circumstances.

In general, we recommend using the Terminal Emulator Configuration Wizard to configure your emulator screen settings. For details, see Configure Emulator Screen Settings Page. You should use the Adjust Configuration option only if you have a good understanding of your terminal emulator settings and of the impact that such changes may have on your tests or business components. For more details, see Manage terminal emulator configuration settings.