You can use the QAWRunLoadTest command to run load test scripts from a command prompt. Enter QAWRunLoadTest /? to view help. To run standard QA Wizard Pro scripts from a command prompt, use the QAWRunScript command. See Running scripts from a command prompt.
Syntax
QAWRunLoadTest.exe virtualusers [workspace] script[:numusers] [/remote computername[:numusers]] [/useragent "useragentstring"[:numusers]] [/scalestartup scaletime] [/runtocompletion | /runtime runseconds] [/reportdir "path" | /reportfile "path" | /noreport] [/Dvariable="value"] [/lsuser username] [/lspassword password] [/lssinglesignon on|off] [/emailresults OnSuccess|OnFailure|Always|Never] [/emailhost host] [/emailport port] [/emailusername username] [/emailpassword passwordincleartext] [/emailusesslencryption TRUE|FALSE] [/emailfrom emailaddress] [/emailto listofemailaddresses] [/emailsubject "subject line"] [/emailmessagebody "message body"] [/sessionname "name"]
Example
The following command runs the Shopping Cart load test script for 120 seconds and gradually adds 50 virtual users over the first 60 seconds of playback.
QAWRunLoadTest.exe 50 "WysiCorpStore.qawwspace" "ShoppingCart.qawloadscript" /scalestartup 60 /runtime 120
Command options
Load test settings
| Item | Description |
|---|---|
| virtualusers | Total number of virtual users to simulate. Cannot exceed the number of virtual users available on the computer running the test. |
| workspace | Workspace filename that contains the scripts to run. Required if the load test script calls another script. |
| script | Script filename. Separate multiple scripts with spaces. |
| :numusers | Number of virtual users to assign to an item, such as a script, computer, or browser. If no value is specified, the total number of virtual users is evenly distributed among items. Can assign a maximum of 250 virtual users to each computer. |
| /remote computername | Run scripts on the specified remote computer. Each remote computer must have QA Wizard Pro installed, QAWRemote.exe running, and a valid license. See Running scripts remotely. |
| /useragent "useragentstring" | User agent or browser to use when running scripts. Internet Explorer 8 is used if no user agent is specified. |
| /scalestartup scaletime | Scale startup to reach 100% load in the specified number of seconds. |
| /runtocompletion | Allow each script to complete and then stop the test. |
| /runtime runseconds | Run the test using each virtual user for the specified number of seconds. If scripts end, they restart and run the remaining duration of the specified time. |
| /sessionname "name" | Playback session name. Only used if playback information is sent to the QA Wizard Pro Server. |
Results reports
| Item | Description |
|---|---|
| /reportdir "path" | Directory path to save the run report in (e.g., C:\Users\<username>\Documents\My Documents\QA Wizard Pro Workspaces\Load Tests\Load Test Reports). |
| /reportfile "path" | Directory path to save the run report in including file name (e.g., C:\Users\<username>\Documents\My Documents\QA Wizard Pro Workspaces\Load Tests\Load Test Reports\Load Test 8-9-2010 11_23_08 AM.qawreport). |
| /noreport | Disable report generation. |
Repository variables
| Item | Description |
|---|---|
| /Dvariable="value" | Set repository variable and value. Overrides default value. |
Email results
| Item | Description |
|---|---|
| /emailresults OnSuccess| OnFailure| Always|Never |
Indicates when to email results.
|
| /emailhost host | Email server host. Enter the domain name (e.g., mailserver.company.com) or IP address (e.g., 192.168.1.100). |
| /emailport port | Port used to communicate with the email server. |
| /emailusername username | Username used to communicate with the email server. |
| /emailpassword passwordincleartext |
Password used to communicate with email server. |
| /emailusesslencryption TRUE | FALSE | Use SSL encryption to communicate with the email server. |
| /emailfrom emailaddress | Sender's email address. |
| /emailto listofemailaddresses | Recipient's email address. Separate multiple addresses with a semicolon. |
| /email subject "subject line" | Email subject line. Must start and end with quotes. |
| /emailmessagebody "message body" | Email message body. Must start and end with quotes. Only one line is allowed. |
Helix ALM Data Warehouse integration
| Item | Description |
|---|---|
| /lsuser | Helix ALM License Server username for ALM Data Warehouse integration. Overrides the saved value on the computer running the script. If not specified, may be prompted to enter username. |
| /lspassword | Helix ALM License Server password for ALM Data Warehouse integration. Overrides the saved value on the computer running the script. If not specified, may be prompted to enter password. |
| /lssinglesignon on|off | Enable or disable single sign-on for use with ALM Data Warehouse integration. Overrides the saved value on the computer running the script. |
Return value
After playback completes, a value is returned to the command prompt to indicate if scripts returned errors or warnings.
| Value | Description |
|---|---|
| 0 | No errors or warnings were returned. |
| Non-zero number | Errors or warnings were returned. Use the output in the command prompt, the results report (if generated), or the status tool to review error information. See Viewing load test results reports and Viewing playback information in the status tool. |
    |
|