Using Command Line Options

Using the WCAT command line options, you can make quick, temporary changes at run time without editing input files. The options apply only to the test being run.

To use these options, include them when entering the run command on the controller computer. You can include more than one option, and you can list options in any order. Unless specified otherwise in the following table, use a space to separate one test option from another on the command line. The following table lists and describes the WCAT command line options.

Table 8 Options for WCAT Tests

Option Description
-a ServerIP Specifies the IP address or addresses of the server or servers to test, where ServerIP is that address or addresses. The -a option overrides the data entered in the config command on the controller computer. Use commas to separate multiple IP addresses. See also -n, following.
-c ConfigFile Specifies the configuration input file for this test. If the -c option is not entered, WCAT looks for a configuration input file with the same name as the test. ConfigFile represents the path and filename of the configuration input file for the test. Configuration input files can have any name, in the form testname.cfg.
-d DistribFile Specifies the distribution file for this test. If the -d option is not entered, WCAT looks for a distribution input file with the same name as the test. DistribFile represents the path and filename of the distribution input file for the test. Distribution input files can have any name, in the form testname.dst.
-e PrefixName Specifies the filename prefix for the configuration, script, and distribution input files and the performance results and log output files, where PrefixName is that prefix. If the -e option is not entered, WCAT uses the name of the test as the filename prefix. You can use the -e option to prevent WCAT from overwriting the files of a previous run of the test.
-l LogFile Specifies the file to which WCAT writes the log. If the -l option is not entered, WCAT writes the log file to the directory from which WCAT was run. LogFile represents the full path to the alternate location.
-m ClientComputers Specifies the number of client computers to be used in the WCAT test, where ClientComputers is that number. The value of the -m option overrides the value specified in the NumClientMachines entry in the configuration file for the test.