Config Get Step in-Place Editing

A Config Get test command retrieves the value of an IxLoad test configuration element into a composite TestComposer variable.

To edit a Config Get test command:

  1. Select the Config Get step in the Test Steps table.
  2. Edit the step parameters as follows:
    • Session: This column displays an IxLoad session name.
    • Return Variable: This column displays a composite return variable name. For each element attribute to be retrieved, a variable member field is created.
    • Command String: This column displays the Configuration Get string, followed by an X-Path expression that corresponds to the IxLoad configuration element whose value is to be retrieved.
    • In addition to the X-Path notation, the select statement also supports the notation that is used by the IxLoad Tcl API, whereby a configuration element is specified using an expression composed of the tree path, an ":" string, and an element index. For example, the "/traffic/trafficItem[2]" expression could be rewritten using the "/traffic/trafficItem:6" specifier, which illustrates the fact that the X-Path index and the Tcl API index referencing an entity of a configuration element are not necessarily the same.

Click into the column and then click the button that displays a drop-down pane as shown in Figure:Config Get GUI :

Figure:Config Get GUI

In the left pane, navigate the IxLoad configuration tree (which mimics the IxLoad Tcl API object hierarchy) and select an element whose value you wish to read.

From the middle pane select the instance(s) of the element currently active in the left pane.

From the right pane, which displays all attributes of the current element instance, choose one or more attributes by selecting its (their) associated control(s).

Example: 

Assuming we had the following Config Get command

Config Get Built-In Event var1 Configuration Get

select="/ixload/repository/test[1] " get="csvInterval

statViewThroughputUnits"

this would return into the var1.csvInterval and var1.statViewThroughputUnits variables the attributes for the test element specified by the select statement.

If we applied this command to multiple tests, say port 1, 2, and 3, the var1.csvInterval and var1.statViewThroughputUnits variables would contain each a space-separated list of attribute values, one value per each test

Since object references returned by the Config Get command are not in the X-Path format used by all other IxLoad session commands, these references can only be passed to commands from the Config category, but not to other IxLoad session commands.