Read Records

The Read Records element is used to read records from a dataset, into a test scenario. The records are then available to be used and referred to in the test scenario.

This will provide the data in the format corresponding to the record layout including packed and numeric fields.

Add Read Records to the Test Scenario by dragging it from the tool palette. This opens the Insert a new Read Records element popup. Here are the fields available when setting up this element:

• ID - a unique name used to refer to output from this element to other elements in this Test Scenario. Reference to this ID by using the format ${myid}.
• Label - an optional descriptive label for the Test Element.
• Description - an optional description of the Test Element.

• Dataset Name - specifies the full dataset name to be read.

  This field supports variable substitution in the form of ${myid} and provides content assist. Type ${ and then press CTRL+SPACE to list the variables.

• Structure Name - attribute points to a Structure in the Structure section of the Total Test Scenario. This structure is where the record layout of the dataset is declared.
• First record to read - this is the first record to be read.
• Number of records - this is the maximum number of records to read.
• OK / Cancel - click on OK to save your element.