Using Dimensions as Variables
Note This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.
Each dimension that is defined on the DTM controller can be used as a variable within a job. When the job is executed, references to the dimension are replaced with the value of the dimension on the client computer.
For example, assume that a program called MyTest.exe requires a command-line argument that indicates the amount of RAM on the computer that MyTest.exe is running on. WTT\RAM is a built-in dimension that provides exactly the information that MyTest.exe needs. You could create a job with a task whose command line is "MyTest.exe [WTT\RAM]" to run the test and pass the amount of RAM as a command-line parameter.
Although any dimension that is defined on the DTM controller can be used as a variable, some dimensions might not have a value on all client computers. For example, a lab manager might create the dimension ComputerManufacturer to indicate the manufacturer of each computer in the lab. Perhaps, however, the lab manager only set a value for the ComputerManufacturer dimension on half of the client computers. A task with the command line "MyTest2.exe [ComputerManufacturer]" would work differently on the client computers whether they did or did not have values for the ComputerManufacturer dimension, as shown in the following table.
| If the value of ComputerManufacturer is... | The command line that is executed is... |
|---|---|
MyCompany |
MyTest2.exe MyCompany |
Undefined |
MyTest2.exe [ComputerManufacturer] |
See Defining and Viewing Dimensions for more information about:
Viewing all dimensions that are defined on the DTM controller.
Defining a new dimension.
Providing a value for a dimension on a client computer.
Build date: 9/14/2012