IBM Support

Rational Performance Tester: Running a schedule from the command line

Technote (troubleshooting)


IBM® Rational® Performance Tester schedules or tests can be executed from the command line outside of the Eclipse workspace

Resolving the problem

1. To run a schedule or test from the command line, go to the directory that contains the cmdline.bat file. This is typically C:\Program Files\IBM\Rational\SDP\6.0\rpt_prod\eclipse\plugins\

2. Issue the following command:

cmdline –workspace drive:\workspace –project testproj –schedule schedule_or_test –configfile file.cfg –eclipsehome workspace_path –results result_file –overwrite {true | false} –quiet –users nn –vmargs JVM_args

1. If a value contains spaces, enclose the value in quotation marks.



Required. The complete path to the Eclipse workspace.


Required. The name of the project relative to the workspace.


Required. The name of the schedule or test to run.


Optional. The complete path and file name for a file that contains the parameters for a schedule run. The entire value of each parameter must be on a single line, so use an editor that does not cause the line to wrap. Command line parameters override the values in this file.


Optional. The complete path to the eclipse root directory. This parameter is required only if you copy the cmdlineexecute.jar file to another location; otherwise, it is superfluous.


Optional. The name of the results file. The default result file is the schedule or test name with a timestamp appended.


Optional. This determines whether a results file with the same name is overwritten. The default value is true, which means that the results file is overwritten.


Optional. Turns off any message output from the launcher and simply returns to the command shell when the run—or the attempt—is complete.


Optional. This overrides the default. For a schedule, the default is the number of virtual users specified in the schedule editor. For a test, the default is one virtual user.


Optional. Java™ Virtual Machine arguments to pass in. For example, –vmargs "–debug –Xmx 512m". The values are in quotation marks because they contain a space.

2. Messages are displayed to indicate when the test or schedule is launched and when it is completed, unless you include the –quiet option.

3.To view the results during the run:
a. Start Performance Tester.
b. Click the project that contains the run,
c. Click File > Refresh to update the results.

4. When you return to the command prompt, the run is finished. Optionally, start Performance Tester to review the results.
The following example runs a schedule named testschedule with the minimum arguments:

cmdline –workspace C:\workspace –project testproject –schedule testschedule

The following example uses a file named runthis.txt to run the same schedule:

cmdline -configfile runthis.txt

The file runthis.txt contains:

workspace = C:\workspace
project = testproject
schedule = testschedule

You can also use standard shell commands to redirect output to a file.

Document information

More support for: Rational Performance Tester
Test Execution

Software version:

Operating system(s): Windows

Reference #: 1227082

Modified date: 15 March 2011