Validating a terminal emulator possible error responses

The following possible error responses may be displayed in the Terminal Emulator pane of the Options dialog box (Tools > Options > GUI Testing tab > Terminal Emulator node) when you click the Validate button:

Invalid HLLAPI DLL

The required HLLAPI or EHLLAPI function cannot be found, because the configured DLL is invalid.

Ensure that you have configured the correct DLL path and name in the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).

For more details, see the table listing the DLL names used by supported terminal emulators in Configure HLLAPI Properties Page, or the documentation provided by your emulator provider.

Cannot detect an open session UFT cannot detect an open terminal emulator session.
  • Ensure that you have opened a current session in your terminal emulator.
  • For HLLAPI emulators, ensure that the emulator short session name is set to the uppercase letter A. You may need to restart the emulator after changing this setting.
Cannot locate the main window class UFT cannot find the terminal emulator main window class name.
  • Ensure that the terminal emulator main window class name is configured correctly in the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).
  • If the main window class name has a postfix that changes each time you launch the emulator, enter only the non-changing portion of the name in the Terminal Emulator Configuration Wizard.
Cannot detect the emulator screen UFT cannot find the terminal emulator main window class name.
  • Ensure that the terminal emulator main window class name is configured correctly in the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).
  • If the main window class name has a postfix that changes each time you launch the emulator, enter only the non-changing portion of the name in the Terminal Emulator Configuration Wizard.
Cannot connect to the open session

Although a current session is open, invoking an HLLAPI function resulted in an error.

Restart UFT and then restart the emulator. If this does not resolve the problem, contact your emulator provider.

Cannot retrieve session text UFT cannot display text captured in the current session.
  • HLLAPI Emulators—Restart UFT and then restart the emulator. If this does not resolve the problem, contact your emulator provider.
  • Non-HLLAPI Emulators—Click Validate again. If the error message is repeated, check that the emulator screen is brought to the front during the validate process (even when using remote access). If this is the case, contact HPE Customer Support.
Cannot detect open session, or Cannot locate the main window class

UFT cannot detect an open terminal emulator session, or find the terminal emulator main window class name.

  • Ensure that you have opened a current session in your terminal emulator.
  • Ensure that the terminal emulator main window class name is configured correctly in the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).
  • If the main window class name has a postfix that changes each time you launch the emulator, enter only the non-changing portion of the name in the Terminal Emulator Configuration Wizard.
HLLAPI ELL not found UFT cannot find the HLLAPI DLL specified for the selected emulator.

Ensure that you have configured the correct DLL path and name in the Terminal Emulator Configuration Wizard (Tools > Options > GUI Testing tab > Terminal Emulator node > Open Wizard).

For more details, see the table listing the DLL names used by supported terminal emulators in Configure HLLAPI Properties Page, or the documentation provided by your emulator provider.

More than one session open

More than one terminal emulator session is currently open.

Close additional sessions.

Unknown error

The validation process failed due to an unknown error.

Restart UFT and then restart the emulator.