DataLoader/MX Reference Manual (H06.03+, J06.03+)

Creating a Customized Version of DataLoader/MX
DataLoader/MX Reference Manual—543544-001
5-38
Miscellaneous Utility Procedures
specified, the job gets its speed enhanced by UPS. If the records do not all fit in the
work space, FastSort transparently falls back to the normal method of sorting.
To request UPS with a 100 KB memory work space for the previous example, use:
asc 2:4 string, asc 5 for 4, desc 10 for 4 integer (UPS 100)
The sort statistics returned by the last call to DTLSort are described by this
structure defined in dtload.h:
struct DTLSortInfo
{
short MaxRecLen;
long NumBufPages; /* 1KB memory buffer pages */
long NumRecs;
long ElapsedTime; /* In centiseconds */
long ScratchSeeks;
long NumCompares;
long IOWaitTime; /* In centiseconds */
long ScratchFileSize; /* In bytes */
long InitialRuns;
short FirstMergeOrder;
short MergeOrder;
short IntermediatePasses;
long NumDupsRemoved; /* Will be zero */
};
This structure corresponds exactly to the statistics returned by the
SORTMERGESTATISTICS procedure described in the FastSort Manual. Note that
NumDupsRemoved is always zero because DTLSort directs FastSort not to
remove duplicates.
Miscellaneous Utility Procedures
These procedures provide additional services.
DTLHash1UnsignedLong
This procedure generates a random 32-bit integer from the key passed.
The syntax is:
DTLStrcmpi
This procedure makes a case-insensitive comparison between two strings that are
standard null-terminated C strings. If Str1 is less than Str2, DTLStrcmpi returns a
negative value. If they are equal, DTLStrcmpi returns 0. If Str1 is greater than Str1,
DTLStrcmpi returns a positive value.
unsigned long DTLHash1UnsignedLong( void* Key, long Len );