Troubleshooting
Problem
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\com.ibm.rational.test.lt.cmdlineexecute_6.1.2.
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.
Option | Description |
–workspace | Required. The complete path to the Eclipse workspace. |
–project | Required. The name of the project relative to the workspace. |
–schedule | Required. The name of the schedule or test to run. |
–configfile | 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. |
–eclipsehome | 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. |
–results | Optional. The name of the results file. The default result file is the schedule or test name with a timestamp appended. |
–overwrite | 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. |
–quiet | Optional. Turns off any message output from the launcher and simply returns to the command shell when the run—or the attempt—is complete. |
–users | 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. |
–vmargs | 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.
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21227082