README.TXT ReadMe File for DBWIN32 version 2.2 September 14, 2002 Copyright (C) 1996-2002 Grant Schenck Software All Rights Reserved. OVERVIEW DBWIN32 is a debug message catching utility for the Window's operating systems. Similar to the 16 bit DBWIN utility it can capture output generated by Win '95/'98 and NT programs using the OutputDebugString() function (TRACE under MFC). In addition, output captured by DBWin32 running on one PC can be viewed remotely via a TCP/IP connection using another copy of DBWin32. In addition to being very useful for program development it also provides a simple way to look inside production systems assuming those programs use OutputDebugString to output important events. This program has been tested on Windows '95, Windows '98, NT NT 3.51, NT 4.0 and NT 5.0. Please report any compatibility issues, bugs or feature suggestions to the email address at the bottom of this file. DBWINV2.ZIP CONTENTS README.TXT This file. DBWINFAQ.TXT Frequently asked questions about DBWin32 Version 2.2. ORDER.TXT Form to be filled out and sent in if registering by email, fax or mail. NOTIFY.VXD The VXD needed to capture output on Windows '95/Windows '98. DBWINTST.EXE A simple test program to generate OutputDebugStrings on request or periodically. DBWIN16.EXE Used by DBWin32 to capture 16 bit output when run on Win '95 along with DBWIND16.DLL. DBWIND16.DLL Used by DBWin32 to capture 16 bit output when run on Win '95 along with DBWIN16.EXE. DBWIN32.EXE The DBWin32 utility itself. INSTALLATION 1) Copy DBWin32.EXE onto your hard drive. You may want to place it in a directory on your PATH so that you can conveniently run it from anywhere. 2) If you are running on Windows '95 or Windows '98 and you want to capture local output then you will need to install the enclosed NOTIFY.VXD. See the instructions below. 3) If you are running on Windows '95 or Windows '98 and you want to capture local 16 bit output then you will need to copy DBWin16.EXE and DBWinD16.DLL to the same directory that you copied DBWin32.EXE to in step 1. 4) Every time you run DBWin32 you will be prompted for a serial number and password. Once you register and enter a valid serial number and password you will no longer see this screen. While you are evaluating DBWin32, click on the Trial button. 5) To test that DBWin32 is working correctly, run the enclosed DBWinTst.EXE program. 6) If you have any problems, check the DBWin32 Frequently Asked Questions file (DBWinFAQ.TXT.) INSTALLING NOTIFY.VXD ON WINDOWS '95 OR '98. 1) Copy NOTIFY.VXD to your windows system directory. 2) In your windows directory, edit your SYSTEM.INI file. 3) Insert in the section [386Enh] the following line: device=notify.vxd 4) Shutdown and restart your machine and proceed from step 3 above. VERSION HISTORY Version 1.0 o Initial Version. Version 1.1 o Added Keep on Top option Version 1.3 (no version 1.2) o Added Keep on Top Tool Bar Button o Added mini-icon for NT 4.0 o Added Close All Windows Tool Bar Button o Added Interleave Output option. This puts all debug output to a single window rather then each process getting it's own window. Version 2.0 o Support for Windows '95 with one time VXD installation. o Remote display of output captured on one PC from another via a TCP/IP connection. o Logging to file facility. o Output tagging options including line number, date, time and process ID (for output captured under NT). o Decoupled UI and logging allows DBWin32 to keep up with very high output rates. o Setable internal buffer size allows DBWin32 to capture output for remote display at a later time. o Extensive options allow system to be configured in various modes: o Local output capture and display. o Local output capture for remote viewing. o Remote viewing of output being captured on another system. o Any mix of the above. o Numerous other features, display enhancements and bug fixes. Version 2.1 o Fixed bug when output occurs during print preview. o Fixed bug where if startup option "Restore previous remote views" was NOT checked, remote views would not be refreshed. o Removed artificial limitation of not allowing remote views to self (i.e., LOCALHOST.) o Added header and footer to print/print preview. Version 2.2 o Added support for 16 bit capture under Windows '95/'98. o Fixed bug where settings (options, window position, etc.) were not saved when windows is shutdown. o Fixed bug where "Get existing data for remote views" option was ignored for remote views when DBWin32 is first opened and when remote views are reconnected. Remote data was ALWAYS being fetched in these cases. DISCLAIMER - AGREEMENT Users of DWIN32 must accept this disclaimer of warranty: "DBWIN32 is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of DBWIN32." REGISTRATION DBWin32 is now free for non-commercial use. Registration is still required for commercial use and accepted for non-commercial use. REGISTRATION BY CHECK You may pay for your registration by filling out the enclosed ORDER.TXT and mailing it along with a check for $50 (US funds only) for each copy ordered to to Grant Schenck Software at the address below. Once we receive your payment we will mail back your serial number(s) and password(s) to register your copy(s) with. Please enclose an email address for a quicker response. REGISTRATION BY CREDIT CARD You can pay for your registration with MC, Visa, Amex, or Discover from Digibuy: http://www.digibuy.com/cgi-bin/product.html?93343308498 Any questions about registration options, product details, technical support, etc, should be directed to Grant Schenck Software at the contact addresses below. Grant Schenck, President Grant Schenck Software schenckg@optonline.net 165 Maple Road Easton, CT 06612 USA +1.203.261.5936