home *** CD-ROM | disk | FTP | other *** search
/ Chronicle of the 20th Century / DKMMCENT.ISO / support / mstools / readme.txt < prev    next >
Text File  |  1994-04-13  |  14KB  |  348 lines
  1. ======================================================================
  2.                WW0440: THE DRWATSON AND MSD DIAGNOSTICS
  3. ======================================================================
  4.                                                    Revision Date: 4/94
  5. ---------------------------------------------------------------------
  6. | INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY    |
  7. | ACCOMPANY THIS DOCUMENT (collectively referred to as an            |
  8. | Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY      |
  9. | KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO    |
  10. | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A     |
  11. | PARTICULAR PURPOSE. The user assumes the entire risk as to the     |
  12. | accuracy and the use of this Application Note. This Application    |
  13. | Note may be copied and distributed subject to the following        |
  14. | conditions: 1) All text must be copied without modification and    |
  15. | all pages must be included; 2) If software is included, all files  |
  16. | on the disk(s) must be copied without modification [the MS-DOS(R)  |
  17. | utility DISKCOPY is appropriate for this purpose]; 3) All          |
  18. | components of this Application Note must be distributed together;  |
  19. | and 4) This Application Note may not be distributed for profit.    |
  20. |                                                                    |
  21. | Copyright 1991 Microsoft Corporation. All Rights Reserved.         |
  22. | Microsoft and MS-DOS are registered trademarks and Windows is a    |
  23. | trademark of Microsoft Corporation.                                |
  24. | Novell is a registered trademark of Novell, Inc.                   |
  25.  --------------------------------------------------------------------
  26.  
  27. Introduction
  28. ------------
  29.  
  30. The disk included with this application note contains DrWatson and
  31. MSD, two programs that aid Microsoft programmers in debugging Windows.
  32. DrWatson is a program that logs information about conditions that
  33. exist when an unrecoverable application error (UAE) occurs. MSD
  34. (Microsoft Diagnostics) is a program that identifies system
  35. configuration information.
  36.  
  37. This application note explains how to install and use DrWatson and
  38. MSD. For Microsoft to most effectively identify and solve system
  39. problems, we ask that you use these programs and periodically send us
  40. the logs that result. The information in this application note
  41. describes what to do when a UAE occurs and how to send Microsoft the
  42. information that you gather.
  43.  
  44. DrWatson
  45. --------
  46.  
  47. DrWatson is a debugging tool designed to provide software programmers
  48. with detailed information on the internal state of Windows when a UAE
  49. occurs. DrWatson must be running at the time a UAE occurs to extract
  50. the internal information from the system.
  51.  
  52. As DrWatson uses very little memory and does not affect the
  53. performance of Windows, we encourage you to install DrWatson if a UAE
  54. has occurred before. After DrWatson is installed, information is
  55. collected when a UAE occurs and written to a special file
  56. (DRWATSON.LOG) located in the Windows directory.
  57.  
  58. DrWatson is a diagnostic tool, not a cure for a problem. Having
  59. DrWatson will not prevent an error from occurring, but the information
  60. in DRWATSON.LOG will help Microsoft developers make the next version
  61. of Windows even better.
  62.  
  63. Microsoft Diagnostics (MSD)
  64. ---------------------------
  65.  
  66. The Microsoft Diagnostics (MSD) program is designed to assist
  67. Microsoft customers and Product Support Services (PSS) technicians in
  68. solving problems with Microsoft products. MSD identifies system
  69. configuration information such as the BIOS, video card type and
  70. manufacturer, installed processor(s), I/O port status, operating
  71. system version, environment settings, hardware devices attached, and
  72. additional software running concurrently with MSD.
  73.  
  74. MSD should be used in conjunction with DrWatson to provide valuable
  75. information on hardware configurations and UAEs. Error reports should
  76. include information from both the MSD program and DrWatson. (The
  77. section titled "When a UAE Occurs" on page 2 of this application note
  78. details the procedure for using MSD with DrWatson.)
  79.  
  80. Installing DrWatson and MSD
  81. ---------------------------
  82.  
  83. We recommend that you start DrWatson automatically each time you start
  84. Windows. This will allow you to collect critical information each time
  85. a UAE occurs.
  86.  
  87. To install MSD and DrWatson and to start DrWatson automatically when
  88. you start Windows, do the following:
  89.  
  90. 1. Place the enclosed disk in drive A.
  91.  
  92. 2. From Windows, start File Manager.
  93.  
  94. 3. From the File menu, choose Copy. In the From and To boxes, type the
  95.    following:
  96.  
  97.       From:  a:\msd.exe
  98.       To:    c:\
  99.       
  100.    Choose the Copy button. The MSD program is now copied to your root
  101.    directory (if your root directory is not on drive C, substitute the
  102.    correct drive letter in the To box).
  103.  
  104. 4. From the File menu, choose Copy. In the From box, type the
  105.    following:
  106.  
  107.       a:\drwatson.exe a:\toolhelp.dll
  108.  
  109.    In the To box, type in the path to your Windows directory (for
  110.    example: "c:\windows" -- without the quotation marks). Choose the
  111.    Copy button. The DrWatson files are now copied to your Windows
  112.    directory.
  113.  
  114. 5. From the File menu, choose Copy. Make a backup copy of your WIN.INI
  115.    file. For example, if your Windows directory is called Windows and
  116.    is on drive C, in the From and To boxes, type the following:
  117.  
  118.       From:  c:\windows\win.ini
  119.       To:    c:\windows\win.bak
  120.  
  121.    Choose the Copy button.
  122.  
  123. 6. Exit File Manager and open Notepad or any text editor. Open the
  124.    WIN.INI file, and in the [Windows] section, add DrWatson to the
  125.    LOAD= line. For example:
  126.  
  127.       [windows]
  128.       Beep=yes
  129.       Spooler=yes
  130.       NullPort=None
  131.       LOAD=DRWATSON.EXE
  132.  
  133. 7. Save the WIN.INI file and exit the text editor.
  134.  
  135. 8. Exit and then restart Windows.
  136.  
  137. DrWatson should now appear as an icon on your desktop.
  138.  
  139. Using DrWatson
  140. --------------
  141.  
  142. DrWatson adds a file to your Windows directory called DRWATSON.LOG. If
  143. a UAE occurs while DrWatson is running, DrWatson captures data
  144. regarding the internal operations of Windows. In addition, DrWatson
  145. prompts you for details on how the UAE occurred. When you type in your
  146. response, please include information on what you were doing or what
  147. steps created the UAE. This information is recorded in the
  148. DRWATSON.LOG file and will help our software programmers track the
  149. problems.
  150.  
  151. At this time, DrWatson does not detect all system errors, so don't be
  152. alarmed if DrWatson does not record information after a particular
  153. system error.
  154.  
  155. Each time a UAE occurs, DrWatson appends new data to DRWATSON.LOG. To
  156. prevent this file from growing too large and to aid our processing,
  157. please save DRWATSON.LOG as a different file periodically. (For
  158. example, if five UAEs occur in one day, save DRWATSON.LOG under a
  159. different name before you start Windows again the next day.)
  160.  
  161. To save the file under a different name, type the following at the
  162. command prompt before you start Windows:
  163.  
  164.    rename c:\drwatson.log <newname>
  165.  
  166. where <newname> is any legal MS-DOS filename, such as SEPT06.LOG. If
  167. your root directory is not on drive C, substitute the correct drive
  168. letter.
  169.  
  170. When a UAE Occurs
  171. -----------------
  172.  
  173. 1. When a UAE occurs, the DrWatson dialog box will appear. Type in a
  174.    description of what you were doing prior to receiving the error.
  175.    Press ENTER.
  176.  
  177. 2. Exit Windows if possible. If exiting is not possible, restart your
  178.    computer.
  179.  
  180. 3. Change to the root directory, and at the command prompt, type "msd"
  181.    (without the quotation marks) and press ENTER to run the MSD
  182.    program. (For LCD and monochrome screens, type "msd /b" and press
  183.    ENTER.)
  184.  
  185. 4. Press R to choose Generate Report. Select the Generate To File
  186.    option. When prompted for a filename, type "msd.log" (without the
  187.    quotation marks and press ENTER. Fill in the information requested.
  188.  
  189. 5. Exit MSD by pressing X.
  190.  
  191. 6. Append the MSD log to the DrWatson log by typing the following at
  192.    the command prompt:
  193.  
  194.       type <p