从命令行初始化变量

要初始化 XML 文件中的测试变量,您可以从命令行界面使用 varfile 选项来运行测试。

开始之前

过程

  1. 要从命令行运行调度或测试,请转至包含 cmdline.batcmdline.sh 文件的目录。 在 Windows 操作系统上,该目录通常是 C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversion_date
  2. 发出以下命令:

    cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_path -suite suite_rel_path -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite {true | false} -quiet -users nn -vmargs JVM_args -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list -usercomments "any user comment"

    如果值包含空格,请在值的两边加上引号。要查看该命令的联机帮助,请在您位于包含 .bat 文件的目录中时,输入 cmdline -help

    下表说明了每个选项:

    选项 描述
    -workspace 必需。指向 Eclipse 工作空间的完整路径。
    -project 必需。与工作空间相关的项目路径(包含文件名)。
    -eclipsehome 必需。指向包含 eclipse.exe 的目录的完整路径。
    -plugins 必需。指向包含插件的文件夹的完整路径。通常情况下,在 Windows 操作系统上,该文件夹位置为 C:\Program Files\IBM\IBMIMShared\plugins
    -schedule 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 所要运行调度的与项目相关的路径(包含文件名)。
    -suite 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 所要运行测试的与项目相关的路径(包含文件名)。
    -varfile 可选。指向包含变量名称-值对的 XML 文件的完整路径。
    -servicename 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 要运行的服务的名称。将运行指定的服务(当它变得可用时)而不是运行调度或性能测试。
    -serviceargs 可选。要传递到 -servicename 选项所指定的服务的参数序列。例如,-serviceargs "-myserviceparm1 myserviceparm1value"。值包含在引号中,因为它们包含空格。
    -configfile 可选。完整路径,指向包含用于调度或测试运行的参数的文件。每个参数都必须位于单个行上。要创建配置文件,请使用不自动换行的编辑器。可在配置文件中设置任何参数(必需或可选均可)。命令行参数将覆盖该文件中的值。
    注: 请勿在该文件中使用引号,即使对于包含空格的值也是如此。
    -results 可选。结果文件的名称。缺省结果文件是附加了时间戳记的调度或测试名称。
    -overwrite 可选。确定是否将覆盖具有相同名称的结果文件。缺省值 true 意味着将覆盖此结果文件。
    -quiet 可选。关闭来自启动程序的任何消息输出,并在运行或尝试完成时返回到命令 shell。
    -users 可选。覆盖运行中虚拟用户的缺省数量。对于调度,缺省值为在调度编辑器中指定的用户数。对于测试,缺省值为一个用户。该选项用于创建调度的包含指定数量用户的新副本。
    -vmargs 可选。要传入的 Java 虚拟机参数。例如,-vmargs "-debug -Xmx512m"。值包含在引号中,因为它们包含空格。
    -exportlog 可选。完整路径,指向要在其中存储所导出 HTTP 测试日志的文件。
    -exportstats 可选。完整路径,指向要在其中存储所导出统计报告数据的目录。统计报告数据以逗号分隔值 (CSV) 格式进行存储,其文件名派生自报告名称。如果未指定 -exportstatreportlist 选项,那么将导出在“性能测试报告”首选项的“导出报告”页面上指定的报告。
    -exportstatreportlist 可选。绝对路径的逗号分隔列表,这些路径指向要在通过 -exportstats 选项导出统计报告数据时使用的定制报告格式文件(.view 文件)。此参数将覆盖工作空间首选项。例如,-exportstatreportlist c:/customreport.view,c:/customreport2.view
    -usercomments 可选。在双引号内添加文本以将其显示在报告的“用户注释”行中。
    注:
    • 除非包含 -quiet 选项,否则将显示消息以指示测试或调度何时启动以及何时完成。
    • 发出此命令将锁定工作空间。要在运行期间检查调度或测试的进度,请调用另一个工作空间并通过该工作空间打开项目。

示例

cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:\Program Files\IBM\SDP\eclipse.exe -schedule MySchedule -varfile C:/Assets/testProjVar.xml


反馈