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 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.
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.
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.
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.
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.
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.
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.
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 One and then restart the emulator.