The tmexecute subcommand starts Rational® ClearQuest® Test Manager tests represented by two ClearQuest record types: configured test cases and test suites. You log into a ClearQuest database and then start a configured test case. The details are shown on the command line. All of the information normally displayed in the test results view is included. Once the test run is complete, the command may or may not commit the results. If you did not commit the results during execution, you can commit the results using the tmcommit command.
You can start the test on the same machine or different machine. The execute command supports the following test types: RFT, RPT, RMT, TPTP JUnit, and TPTP URL. Rational ClearQuest Test Manager starts in the context of an Eclipse-based tool. The test type must be supported by the tool. RFT, RMT, RPT, or Eclipse with TPTP are candidates for Eclipse tools. You specify the Eclipse executable for the testing tool on the command line. The command is synchronous. That is CQTool does not gain control until the command has completed. When Rational ClearQuest Test Manager completes execution, detailed information about execution is passed back to CQTool. Standard behavior for ClearQuest commands apply to tmexecute. You can also supply the name of the database and credentials on the command line. If you leave out the required commands during interactive mode, you are prompted for the missing parameters.
A simple execution.
cqtool>tmexecute -id QEMS00000186 -iteration it1 -startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Execution to a specific computer. By default, it runs the test on the local machine, but when a computer is specified, it executes on the specified computer.
cqtool>tmexecute -id QEMS00000186 -computer labcomputer -iteration it1 -startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Execution to a specific computer group.
cqtool>tmexecute -id QEMS00000186 -group mygroup -iteration it1 -startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Execution with a specific build name.
cqtool>tmexecute -id QEMS00000186 -bname build101 -iteration it1 -startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Execution with a specific build record. Build records are looked up by the build name.
cqtool>tmexecute -id QEMS00000186 -brecord buildrec101-iteration it1 -startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Execution with a specific ClearCase view. The script is executed out of the view specified with-view.
cqtool>tmexecute -id QEMS00000186 -view c:\\views\\myview -it it1-startup C:\\Program Files\\IBM\\SDP70\\eclipse.exe
Simple execute and commit command.
cqtool>tmexecute -id QEMS00000186 -commit