## Display Device Driver Reference for OS/2

[prev][next][parent][TOC]

### Locating, Preloading, and Loading Test-Case DLLs

DTT uses the following sequence to locate test-case DLLs:

1.DLLs specified using the -T command-line option are preloaded during DTT startup. Preloaded DLLs remain resident for the duration of the DTT session .

The -T command-line option specifies a search pattern for locating the test -case DLLs to be preloaded. The -T option value can contain global file- name characters (wildcards) in the file name. If the -S option also is specified on the command line, test-case DLL names are located using the same search pattern, but the DLLs found are loaded by searching LIBPATH. Following are examples of how to preload DLLs:

      Preload GREBTMP.DLL from LIBPATH.

         DTT /tgrebtmp.dll /s

      On the currrent drive, preload all DLLs in the DTT\DLL directory.

          DTT -T\DTT\DLL\*.DLL

The -T command-line option can be specified multiple times.

2.Test-case index files specified using the -N command-line option are loaded. (See Creating a Test-Case Index File for information on creating test-case index files.)

A DLL containing a specific test case is loaded only when that test case is executed; the DLL remains resident only until a test case resident in another DLL is executed. If the -S option also is specified on the command line, DTT uses LIBPATH to locate the test-case DLLs specified in a test- case index file. Following are examples of how to load test-case index files:

      Load the testndx1.ndx and testndx2.ndx test case index files.

         DTT /NE:\DTT\INDEX\testndx1.ndx -nC:\COMMON\testndx2.ndx

      Load the testindx.ndx from the current directory.

The -N command-line option can be specified multiple times.

3.At this point, if no test cases have been identified to DTT, DTT attempts to load a test-case index file named TESTINDX.NDX from the current directory.

4.Then, if test cases still have not been identified to DTT, DTT attempts to preload any test-case DLLs it locates, using an "*.DLL" search pattern. The search pattern searches the current directory, if the -S command-line option is not specified, or LIBPATH, if the -S option is specified.

5.If DTT fails to locate any test cases, a message to that effect is issued.

The -S command-line option orders DTT to search LIBPATH when attempting to load a test-case DLL. If the -S option is not specified, DTT searches only the specified path (or current directory if no path is specified) to locate test-case DLLs.

The -S command-line option is most useful when using a test-case index file , as shown in the following example:

         DTT -Ntestindx.ndx -S

The names of all test cases must be made known to DTT during startup. This can be accomplished in the following ways:

Loading test-case index files
Preloading test-case DLLs