Previous Topic: Message-Correlation ID Generator Data SetNext Topic: XML Data Set


Load a Set of File Names Data Set

The Load a Set of File Names data set assigns a value to a property based on a filtered set of file names from the file system.

The set of file names can include all the files in a specific directory, or a set that a "file pattern" filters. Another option lets you include subdirectories in the set, recursively. The files are returned in a case-sensitive, alphabetical order, top directories first, followed by subdirectories (using depth first ordering). Each time the data set is used, it returns the next file name (full path name) in the data set. This file name is stored in a property with the same name as the data set.

Complete the following fields:

Name

Enter the name of the data set.

Local

Designates whether the data set is global or local. Global is the default. Local data sets are created with one for each simulator. Global data sets are created once and shared by all simulators.

Random

Whether the record after the current record (sequential access) is read, or a random record is read. Sequential reading is the default.

Max Records to Fetch

The upper bound on the number of records to fetch for random access. This text field is disabled if the Random check box is not selected.

At End Of Data

Select the action for the end of the data set. You can start over, reading values from the start of the data set, or you can select the step to execute.

Directory Location

The full path name of the directory to scan, or you can browse using the Browse button.

File Pattern

A filter pattern string, using an asterisk (*) as a wild card if appropriate.

Include Files from Subdirectories

If the files in subdirectories are listed, select this option.

Click Test and Keep to test and load the data. You get a dialog that confirms that the data set can be read, and shows the first set of data.

Note: A large amount of data could take longer than you want; use the Cancel button to stop the operation.