DataLoader/MX Reference Manual (G06.24+)

Creating a Customized Version of DataLoader/MX
DataLoader/MX Reference Manual—525872-002
5-32
Generating Test Data
Shuffle
is a flag that indicates whether the contents of Name are to be returned in a
randomized way by DTLCartGenerateField or whether they are to be returned in
the order they are in the file. A nonzero value causes them to be returned in a
randomized way. This strategy is useful because, although it is much easier to
maintain files with lists when the lists are in some order, you would not usually
want that order to be carried over into the test data.
There can be a maximum of 10 Cartesian fields, and each Cartesian field can have a
maximum of 10 columns.
DTLCARTADDCOLCOB
This procedure adds a column to a Cartesian field. It can be called from COBOL
programs.
The syntax is:
Field
is a value from 1 through 10 that specifies the field to which the column is to be
added.
Name
is the name of a file that contains the values the column will contain, with one value
per record.
Len
is the length of the Name parameter.
Shuffle
is a flag that indicates whether the contents of Name are to be returned in a
randomized way by DTLCartGenerateField or whether they are to be returned in
the order they appear in the file. A nonzero value causes them to be returned in a
randomized way. This strategy is useful because, although it is much easier to
maintain files with lists when the lists are in some order, you would not usually
want that order to be carried over into the test data.
There can be a maximum of 10 Cartesian fields, and each Cartesian field can have a
maximum of 10 columns.
DTLCartGenerateField
This procedure returns the next values for each of the columns in the specified field.
There must be as many pointers to fields for DTLCartGenerateField to store these
void DTLCARTADDCOL(short Field, char* Name, short Len,
short Shuffle );