                 T r a c e P l u s 3 2 / D B - L i b r a r y
                         DB-Library Spy/SQL Capture


=========================================================================
INSTALLATION

To install the TracePlus demonstration, unzip these files to a temporary directory 
and select "Run..." from the "File" menu of the Program	Manager. Then type:

    [drive letter]:\[download directory]\setup.exe
	
Remember to replace the words "drive letter" and "download directory" with the appropriate
locations on your computer where you unzipped the .ZIP file. Press Ok or <ENTER> to setup 
TracePlus32/DB-Library.

***** IMPORTANT *****

You must point TracePlus32/DB-Library at the correct location of NTDBLIB.DLL or
LIBSYBDB.DLL that is being invoked by the application. You do this by selecting
"API Location" from the "File" menu. TracePlus defaults to Windows(WINNT)\System.

Note that some applications (such as Microsoft SQL Server) may install the DLL 
in the same directory as the application. TracePlus will not be able to spy on
the application unless the correct location is specified.

=========================================================================
SAMPLE LOG FILE

We have included two trace log files that was generated using the Export feature, so
that you can see what this feature provides. To load the sample log file, select Import
from the Trace menu, then choose either SAMPLE.RDF or WINSOCK2.RDF (it will be in the 
same directory as TracePlus). Be sure to view the PC Configuration (This log was 
generated from the author's machine).

=========================================================================
NOTES ON 32 BIT VERSIONS OF TRACEPLUS

32 bit versions of TracePlus use the standard Microsoft 
defined debugging interface for Win32 applications. The 
Microsoft interface does not permit detaching from a process 
after debugging has started. Therefore, if TracePlus is 
terminated, it will also terminate all processes being traced. 
Stopping the trace will not detach TracePlus from a process.

-------------------------------------------------------------------------
Be sure that if you are tracing a server application,  leave 
the TracePlus32 application running after stopping the 
trace, or terminate the server application, and restart 
it (be sure that TracePlus32 is not running or the trace 
is stopped before starting the server application again).

-------------------------------------------------------------------------
TracePlus32 can trace a Win32 console application. To do this, 
launch the console application from TracePlus32. See the topic 
"Setting Filters" in the help file for more details on this procedure.

-------------------------------------------------------------------------
TracePlus32 does not trace 16 bit Windows applications.

=========================================================================
GENERAL NOTES

The trace buffer size is limited to storing up to 100 most recent trace 
records. The monochrome, file, and printer log options in the Options dialog 
box will also be disabled. Otherwise all other features are fully functional.

Note: This demonstration does not require WINSOCK.DLL on the 	
system in order to execute. However, it won't be much of a demon- 	
stration!
