-workspace |
Required. The complete path to the Eclipse workspace. |
-project |
Required. The path, including the file name, of the project
relative to the workspace. |
-eclipsehome |
Required. The complete path to the directory that contains eclipse.exe. |
-plugins |
Required. The complete path to the folder that contains the
plug-ins. Typically, on Windows operating
systems this folder location is C:\Program Files\IBM\IBMIMShared\plugins. |
-schedule |
Optional, but you must specify the -schedule option,
the -suite option, or the -servicename option.
The path including the file name of the schedule to run relative to
the project. |
-suite |
Optional, but you must specify the -schedule option, the -suite option,
or the -servicename option. The path including the
file name of the test to run relative to the project. |
-varfile |
Optional. The complete path to the XML file that contains the variable name and value
pairs. |
-servicename |
Optional, but you must specify the -schedule option, the -suite option,
or the -servicename option. The name of the service
to run. Instead of running a performance test, the specified service
is run when it becomes available. |
-serviceargs |
Optional. The series of arguments to pass to the service specified
by the -servicename option. For example, -serviceargs
"-myserviceparm1 myserviceparm1value". The values are
in quotation marks because they contain spaces. |
-configfile |
Optional. The complete path to a file that contains the parameters for a test or schedule run. Each parameter must be on a single line. To create a
configuration file, use an editor that does not wrap lines. Any parameters, whether required or
optional, can be set in the configuration file. Command line parameters override the values in this
file. Note: The file must be in the UTF-8 format. Do not use quotation marks in this file, even for
values that contain spaces.
|
-results |
Optional. The name of the results file. The default result file is the test or schedule name with a time stamp appended. Specify a folder name that is
relative to the project to store the test results. For example, -results
folder/resultname. |
-overwrite |
Optional. Determines whether a results file with the same
name is overwritten. The default value, true,
means that the results file is overwritten. |
-quiet |
Optional. Turns off any message output from the launcher and
returns to the command shell when the run or the attempt is complete. |
-users |
Optional. Overrides the default number
of virtual users in the run. For a schedule, the default is the number
of users specified in the schedule editor. For a test, the default
is one user. This option creates a new copy of the schedule that contains
the specified number of users. |
-vmargs |
Optional. To specify the Java maximum heap size for the Java process that controls the
command line playback, use the -vmargs option with the
-Xmx argument. For example, when you use -vmargs
-Xmx4096m, you specify a maximum heap size of 4096m. This way is similar to specifying
-Xmx4096m in the eclipse.ini file for the workbench when playing back the
test from the user interface.
For a cloud run,
specify -vmargs -Dcloudcostconfirm.
|
-exportlog |
Optional. The complete path to a file in which to store the
exported HTTP test log. |
-exportstats or -exportstatshtml |
Optional. The complete path to a directory in which to store exported statistical report
data. The statistical report data is stored in comma-separated values (CSV) format, with the file
name derived from the report name. If the -exportstatreportlist option is not
specified, the reports specified on the Export Reports page of the
Performance Test Report preferences are exported. Use
-exportstatshtml only when you want to export web analytic results. The results are
exported in a compressed format to the specified directory. Extract and analyze the results on a web
browser without using the test workbench.
|
-exportstatreportlist |
Optional. A comma-separated list of absolute paths to custom
report format files (.view files) to use when exporting statistical
report data with the -exportstats option. This parameter
overrides workspace preferences. For example, -exportstatreportlist
c:/customreport.view,c:/customreport2.view. |
-usercomments |
Optional. Add text within double quotation mark to display
it in the User Comments row of the report. Note: On Windows, to add
comments in a native language that might not support Unicode characters,
it is recommended to use the CommandLine.exe file to run the command.
|