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.

Back to top

Cannot detect an open session

UFT One 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.

Back to top

Cannot locate the main window class

UFT One 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.

Back to top

Cannot detect the emulator screen

UFT One 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.

Back to top

Cannot connect to the open session

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

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

Back to top

Cannot retrieve session text

UFT One cannot display text captured in the current session.

  • HLLAPI Emulators—Restart UFT One 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 Software Support.

Back to top

Cannot detect open session, or Cannot locate the main window class

UFT One 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.

Back to top

HLLAPI ELL not found

UFT One 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.

Back to top

More than one session open

More than one terminal emulator session is currently open.

Close additional sessions.

Back to top

Unknown error

The validation process failed due to an unknown error.

Restart UFT One and then restart the emulator.

Back to top