TestComplete.exe provides the following exit codes, which report on the results of the last test:
|0||The last test did not produce errors or warnings.|
|1||The last test results include warnings but no errors.|
|2||The last test results include errors.|
|3||The test cannot be run because of an error. Some typical errors are:
The test engine also returns the code 3, if you run a project or project suite and the test was stopped with a call to the Runner.Stop method within the
|4||The test run was stopped by the timeout specified with the
|127||Unable to launch TestComplete, because some TestComplete files are missing or the installation is damaged.|
|1000||Unable to launch TestComplete, because another instance of TestComplete is already running.|
|1001||Unable to start TestComplete, because there is not enough free disk space.|
|-1||Unable to launch TestComplete because the license check has failed and TestComplete cannot obtain a license. You can find information on TestComplete licensing in TestComplete Licensing.
To resolve licensing problems, please use the Licensing Troubleshooter on our web site:
|Other codes||You may receive codes different from those above (for example, -10, -12). This can happen if your operating system, firewall, or a third-party application that manages TestComplete test runs overwrites the actual TestComplete exit code.
In this case, to learn the received exit code definition, contact your system administrator or the SmartBear Support team.
The exit codes that TestComplete returns depend on whether the project is configured to rerun failed tests. See Stop and Rerun the Current Test Item After an Error for all the details.
Normally, these codes are of use when TestComplete is launched from a batch file. The following example uses the 32-bit version of TestComplete. If you use 64-bit, the TestComplete executable is located in the <TestComplete>\x64\Bin folder.
REM Clears the screen
REM Launches TestComplete,
REM executes the specified project
REM and closes TestComplete when the run is over
"C:\TestCompleteFolder\Bin\TestComplete.exe" "C:\TestCompleteProjects\MyProj\MyProj.mds" /run /exit
IF ERRORLEVEL 1001 GOTO NotEnoughDiskSpace
IF ERRORLEVEL 1000 GOTO AnotherInstance
IF ERRORLEVEL 127 GOTO DamagedInstall
IF ERRORLEVEL 4 GOTO Timeout
IF ERRORLEVEL 3 GOTO CannotRun
IF ERRORLEVEL 2 GOTO Errors
IF ERRORLEVEL 1 GOTO Warnings
IF ERRORLEVEL 0 GOTO Success
IF ERRORLEVEL -1 GOTO LicenseFailed
ECHO There is not enough free disk space to run TestComplete
ECHO Another instance of TestComplete is already running
ECHO TestComplete installation is damaged or some files are missing
ECHO Timeout elapses
ECHO The script cannot be run
ECHO There are errors
ECHO There are warnings
ECHO No errors
ECHO License check failed
|When launching TestComplete from a command line or batch file, it is not recommended to use the RunAs command, since this will significantly slow down the test execution.|