-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, false, means that the new results file is created. If the value is
true, the file is overwritten and retains the same file name. |
-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 |
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
-timerange attribute along with -exportstats to export the data of
specific time ranges in a run. The value is the time range that you specified in the schedule. For
example, "5 Users,10 Users". Separate time ranges with a comma and use double quotes when there is
space in time range.
|
-exportstatshtml |
Use -exportstatshtml only when you want to export web analytic results. The
results are exported in the specified directory. Analyze the results on a web browser without using
the test workbench.
|
-compare |
Use -compare attribute along with -exportstatshtml to export
the result in the compare mode. The value can be paths to the runs and are relative to the
workspace. Separate the paths by a comma.
|
-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.
|