home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 17 Fixes30 / 17-Fixes30.zip / warpdump.zip / trapdump.fax next >
Text File  |  1995-01-30  |  9KB  |  262 lines
  1. File:TRAPDUMP.fax  11/30/94
  2.  
  3. TITLE:  THE OS/2 DUMP PROCESS
  4.  
  5. SUMMARY OF RESOLUTION:
  6.  
  7. A utility exists in OS/2 (including Warp) to dump all of the physical 
  8. memory to diskette. The dump is helpful in some situations to identify 
  9. a failing component in an OS/2 system.
  10.  
  11. ** THE DUMP PROCESS **
  12.  
  13. 1.  THE NEW DUMP PROCEDURE
  14.  
  15. A) OS/2 2.0, 2.1 and 2.11 do not contain the latest dump files.
  16. You must install the new dump procedure (NEWDUMP.ZIP) on the
  17. system before taking a system dump. NEWDUMP.ZIP can be
  18. obtained from our bulletin board at (407) 443-8000.
  19.   - Logon with your own name and password.
  20.   - At the main menu press F for files.
  21.   - S to Select a library.
  22.   - 8 (enter)
  23.   - D to download a file.
  24.   - Newdump.zip (enter)
  25. There is a readme with this file which explains how to apply
  26. newdump to the system.
  27.  
  28.  
  29. B) Warp updates are in warpdump.zip. This update applies only to Warp.    
  30.  
  31. C) OS/2 2.0 requires XR06100 (service pak II) as a prerequisite for 
  32.     newdump.
  33.  
  34. ** To perform a system dump you will need blank formatted diskettes.
  35. The number of diskettes needed depends on the amount of memory
  36. in your system.  For every two mb of memory you will need approximately
  37. one 1.44 diskette (the swapper file is not relevant to the dump).
  38.  
  39. 2.  STARTING THE TRACE
  40.  
  41. NOTE:  DO NOT INVOKE TRACE UNLESS INSTRUCTED TO BY AN IBM TECHNICAL
  42. ANALYST.
  43.  
  44. For OS/2 prior to OS/2 2.1, add the following lines in
  45. config.sys:
  46.  
  47. TRACE=ON
  48. TRACEBUF=63
  49. TRACE=OFF 4,24,47,50,97,98
  50.  
  51. and then reboot the machine.
  52.  
  53. The above starts TRACE function and turns off major codes 4, 24, 
  54. 47,50, 97, and 98.  The default for TRACE=ON is to trace all system
  55. events. These major codes are for some housekeeping functions 
  56. hat are not normally used by development.
  57.  
  58. For OS/2 2.1, add the following lines to the config.sys (exactly):
  59.  
  60. TRACEBUF=63
  61. TRACE=ON
  62.  
  63. then reboot the machine.
  64.  
  65. For OS/2 2.1, enter the following commands from a command prompt
  66. after the reboot noted just above:
  67.  
  68. TRACE ON KERNEL
  69. TRACE ON DOSCALL1
  70.                                          
  71.  
  72. 3.  There are several types of memory dumps:
  73.  
  74. Different situations determine which type of dump is needed.  IBM
  75. OS/2 Support will help to determine which process is correct for
  76. your situation.
  77.  
  78. A.  OS/2 2.0, 2.1, OR 2.11 (with no fixpacks)
  79.  
  80.     1.  AUTOMATIC DUMP PROCESS (Only to be used for Ring 3 Traps)
  81.  
  82.      In CONFIG.SYS enter the following:
  83.  
  84.      TRAPDUMP=ON
  85.  
  86.      This will cause an automatic DUMP if the failing CS:EIP is 
  87.      in Ring 3 code (the CS value will end in either 3, 7, B or F). 
  88.  
  89.      It will not DUMP on Ring 0 code traps.  (Applications run 
  90.      at Ring 3 while the OS/2 Kernel runs at Ring 0.)
  91.  
  92. **OR***
  93.  
  94.     2.  MANUAL DUMP PROCESS
  95.  
  96.      It is also possible to start a MANUAL DUMP of the system.  
  97.      Press and hold "Ctrl+Alt" and then press "Num Lock" twice.  
  98.      This will start the dump process in most cases, even if the 
  99.      keyboard is locked.
  100.  
  101.  
  102.  
  103. B.  OS/2 2.11 WITH FIXPACK (36 or later) OR WARP
  104.  
  105.      1.  AUTOMATIC DUMP PROCESS FOR RING 0 TRAPS (dumps BOTH
  106.      ring 0 and non-ring 0 traps)
  107.  
  108.      In the CONFIG.SYS enter the following:
  109.  
  110.      TRAPDUMP=ON
  111.  
  112.      This will cause an automatic DUMP.
  113.  
  114. **OR**
  115.  
  116.      2.  AUTOMATIC DUMP PROCESS FOR RING 0 TRAPS (dumps ONLY
  117.      ring 0 traps)
  118.  
  119.      In the CONFIG.SYS enter the following:
  120.  
  121.      TRAPDUMP=R0
  122.  
  123.      This will cause an automatic Dump if the Failing CS:EIP is in
  124.      Ring 0 code (the EIP will end in 0, 4, or 8).  It will not DUMP
  125.      Ring 3 traps.  (The OS/2 kernel and device drivers run at
  126.      Ring 0 while applications run at Ring 3).
  127.  
  128.      This will cause an automatic DUMP.
  129.  
  130. **OR**
  131.  
  132.      3.  MANUAL DUMP PROCESS
  133.  
  134.      It is also possible to start a MANUAL DUMP of the system. 
  135.      Press and hold "Ctrl+Alt" and then press "Num Lock" twice.  
  136.      This will start the dump process in most cases, even if the 
  137.      keyboard is locked.
  138.  
  139.  
  140.     4.  TAKING THE DUMP
  141.  
  142.     When the dump is started, either automatic or manual, the 
  143.     screen goes blank and the user is instructed to insert a blank 
  144.     formatted diskette.  The user will be prompted for additional 
  145.     diskettes as needed and then instructed to insert the DUMP 
  146.     diskette a second time.  When this is finished, the system 
  147.     can be re-booted to return to normal operation.
  148.  
  149.     Note that no register information is displayed when an 
  150.     automatic dump is taken.  The register information is 
  151.     contained in the dump information.
  152.  
  153. 5.  How to read the Trap information from the dump diskettes.
  154.  
  155.     To view the dump diskettes for the revision of the kernel and
  156.     the trap infromation:
  157.     - Place the first dump diskette into the floppy drive and from 
  158.       the a:  prompt type:  e dumpdata.001 (enter).
  159.     - You will receive a message that the editor detected embedded
  160.        null characters as it read the file.
  161.        Press: continue loading file
  162.     - A screen of unreadable characters will appear.
  163.     - Press edit, find,  find: revision
  164.       This will find the level of the kernel you are running.
  165.       (eg, 6.617 for OS/2 2.11,  8.162 for Warp, etc.)
  166.     - You can also search on the cs:eip to see if the trap screen is 
  167.        present.
  168.        Place the mouse pointer at the begining of the file.
  169.        Press edit, find  find: CS:EIP
  170.        If a trap is present it will display the registers.  (Sometimes
  171.        more than one trap is found in the dump.  If the registers are
  172.        all x's, press find again to see if there are additional traps.)
  173.  
  174.   **WARNING**
  175.        DO NOT edit the file by adding characters or spaces.  This can
  176.        cause the dump to be unreadable.  Once you have completed
  177.        viewing the dump, always exit without saving the file because 
  178.        it may cause the dump to be unreadable.  If you have made 
  179.        any changes to the file by accident, also exit without saving  
  180.        the file.
  181.  
  182.  
  183. DETAILS OF RESOLUTION:
  184.  
  185. 6.  MAILING THE DUMP TO IBM
  186.  
  187. DO NOT send dump diskettes unless instructed by Level 2 Support.
  188. Diskettes MUST be clearly labeled with the PMR# or APAR# and your
  189. name.  Please ensure diskettes are numbered as well.
  190.  
  191. DUMP diskettes should be sent to:
  192.  
  193. IBM Corp.
  194. 1000 NW 51st Street
  195. Boca Raton, FL 33432
  196. ATTN:  (Name of the OS/2 Analyst requesting the dump), Bldg 001-3
  197. Internal Zip 1024
  198.  
  199. ** For IBM Internal Customers ONLY**
  200.  
  201. Disk images may be created using OS2IMAGE.EXE (OS2TOOLS), no other
  202. utility, e.g.LOADDSKF, is acceptable.  Please send the disk images
  203. to the vm id given to you by the OS/2 Analyst.  The dump formatter
  204. requires disk images (as opposed to just the contents of each
  205. diskette).  We do not have the capability to  download dumps from
  206. IBMLINK, the PCC BBS, COMPUSERVE, etc, although we may be able
  207. to arrange for you to upload to our SDM.
  208.  
  209. ** HOW TO DUMP TO HARDFILE**
  210.  
  211. NOTE! NOTE! NOTE!
  212. Dump to hardfile must be to a separate, empty partition.
  213.  
  214. IT WILL ERASE WHATEVER IS ON THE PARTITION.
  215.  
  216. You MUST install newdump on the system if you are running OS/2 2.0,
  217. 2.1, or 2.11.
  218.  
  219. 1.  Create a partition about 4meg larger than the amount of memory 
  220.    installed.
  221. 2.  Format the partition FAT.
  222. 3.  Label the partition  SADUMP.
  223. 4.  Modify config.sys as follows:
  224.        trapdump=off,X:      where X: is the partition letter
  225. 5.  REBOOT
  226.  
  227. - To initiate the dump to hardfile, hit ctl-alt-numlock-numlock 
  228.   16megs should dump in under a minute!!!
  229.  
  230.  A good test would be to run chkdsk on a large enough drive (do 
  231.  not run chkdsk /f, just chkdsk). Then while chkdsk is still running, 
  232.  initiate the dump.
  233.  
  234. - Some modifications have been made to the dump to hardfile on 
  235.   8/1/94:
  236. 1.  A message will now display, informing the user of which partition  
  237.    will be dumped to, and how much memory.
  238. 2.  A warning message will display informing the user that the dump 
  239.    will wipe out the dump partition. The user has 30 seconds in which 
  240.    to respond. If the user does not answer in 30 seconds, the dump  
  241.    begins.
  242. 3.  If the user chooses not to dump to the hardfile by answering N to 
  243.    the above prompt, he is asked if he would like to dump to diskette.
  244. 4.  If an error is encountered, and the dump cannot proceed to the 
  245.    hardfile, the user is asked if he would like to dump to diskettes. 
  246.    If the answer is no, or there is no response in 60 seconds, the 
  247.    system is rebooted.
  248.  
  249. -  Major modifications were made to both the dump to hardfile and to 
  250.   diskette on 11/01/94.
  251.   1.  Improved error checking on dump to hardfile and diskette.
  252.   2.  More descriptive error messages.
  253.   3.  NOTE: if there is a bad sector encountered when dumping to 
  254.       hardfile, a Fatal Dump Error message will display followed by 
  255.       the bad sector information to help pinpoint the error.
  256.       There is currently no error recovery in dump to hardfile.
  257.  4.  Support for systems with 64meg or more of memory installed.
  258.      DO NOT USE a dump dated prior to 11/01/94 on systems with 
  259.      64 meg or more.
  260.  5.  Better performance.
  261.  6.  Improved error recovery from bad diskettes.
  262.