-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.
To enable
Web Analytics reports when running the test from the command line, use -vmargs
-DltStats=2.
|
-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.
|