tmexecute

Starts configured test cases and test suites.

Synopsis

tmexecute [common arguments]

Description

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.

Options and arguments

-i/teration iteration name
Specifies the name of the iteration to start.
-id configured test cases or test suite record id [configured test cases or test suite record id]
Specifies the name of one or more one or more configured test case or test suite record IDs to start.
[-c/ommit]
Optional. Specifies the option of committing the results of the test.
[-co/mputer computer name [computer name] *]
Specifies to run the test on one or more computers.
[-g/roup computer group [computer group] *]
Specifies to run the test on one or more computer groups.
[-bn/ame build name]
Specifies the build name for the test.
[-br/ecord record id]
Specifies the build record id for the test.
[-v/iew ClearCase view path]
Specifies the configured test cases that exist in a view and the path of the view.
[-s/tartup Eclipse executable path ]
Specifies the executable to run when Rational ClearQuest Test Manager is started. This is typically eclipse.exe or clearquest.exe. For example, C:\\Program Files\\IBM\\SDP70\\eclipse.exe or C:\\Program Files\\Rational\\ClearQuest\rcp\clearquest.exe. When -startup is not specified, the ClearQuest RCP client is used.

Examples

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 

Feedback