home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / os2pdp.zip / README < prev    next >
Text File  |  1994-04-18  |  10KB  |  294 lines
  1.                                                            15 April 1994
  2.  
  3.           Problem Determination Package for OS/2* 2.1 (V 0.2)
  4.  
  5. THIS PACKAGE IS DESIGNED TO BE USED WITH THE OS/2 2.1 PRODUCT.  YOU MUST
  6. BE A CURRENT LICENSEE OF OS/2 2.1 IN ORDER TO USE THIS PACKAGE.  THIS
  7. CODE IS GOVERNED BY THE TERMS AND CONDITIONS OF THE OS/2 PROGRAM LICENSE
  8. AGREEMENT.
  9.  
  10. This package contains a set of OS/2 2.1 programs and APIs that are
  11. useful for problem determination; both for program development and for
  12. defect resolution.
  13.  
  14.  
  15. SUPPORTED FEATURES
  16. ------------------
  17.  
  18.   For Traps/Hangs
  19.   ---------------
  20.   o  System Dump to Diskette
  21.   o  System Dump to Hard File
  22.   o  Process Dump
  23.   o  Trap Dump
  24.  
  25.  
  26.   For Debugging
  27.   -------------
  28.   o  System Trace (TRACE)
  29.   o  Error Logging
  30.  
  31.  
  32.   For Analysis
  33.   ------------
  34.   o  Trace Formatter (TRACEFMT)
  35.   o  Dump Formatter  (PMDF)
  36.   o  Error Log Formatter (SYSLOG)
  37.  
  38.  
  39. INSTALLATION INSTRUCTIONS
  40. -------------------------
  41.  
  42. Note:  you should first "de-install" any previous versions that you
  43. may have installed.
  44.  
  45. 1. Open the object that contains the OS2PDP installation code.  For
  46.    example, open the object labeled "Drive A".
  47.  
  48. 2. Open the object labeled "PDPInst.Cmd".
  49.  
  50.    A folder called Problem Determination will be created on the
  51.    desktop.
  52.  
  53. 3. If you have OS/2 2.1 GA or S3, you may experience a flashing effect
  54.    on your PMDF output screen which causes performance degradation.
  55.    This effect is corrected on the latest release of OS/2 2.1 MR1/SP.
  56.    If you don't have the OS/2 MR1/SP release, then you may wish to use
  57.    the version of PMMLE.DLL included in this package (located in the
  58.    PMDF directory).  To install this new DLL:  1) boot with the OS/2
  59.    installation diskettes and copy the new PMMLE.DLL to the \OS2\DLL
  60.    directory, or, 2) copy the new PMMLE.DLL to the root of your boot
  61.    drive (e.g. c:\).
  62.  
  63. 4. A new version of the CONFIG.SYS file is created under the file name
  64.    CONFIG.PDP.  It contains your original CONFIG.SYS statements plus
  65.    these additional statements, providing that they were not already
  66.    in the file:
  67.      TraceBuf=63
  68.      Trace=ON
  69.      TrapDump=OFF,A:
  70.      DumpProcess=c:    (where c: is your boot drive)
  71.      SuppressPopUps=c: (where c: is your boot drive)
  72.      Device=ipath\DDINFO.SYS (where ipath is the installation path)
  73.  
  74.    Please replace the existing CONFIG.SYS file or add similar statements
  75.    statements prior to re-booting your system.
  76.  
  77.    For Your Information
  78.    --------------------
  79.    a. The install program creates a new version of the following
  80.       files, but first saves the originals in *.PDP:
  81.         \OS2DUMP
  82.         \OS2\SYSLOG.EXE
  83.         \OS2\SYSLOGPM.EXE
  84.         \OS2\DLL\SYSLOG.DLL
  85.         \OS2\HELP\SYSLOGH.HLP
  86.         \OS2\TRACE.EXE
  87.         \OS2\TRACEFMT.EXE
  88.         \OS2\DLL\TRACEFMT.DLL
  89.         \OS2\HELP\TRACEFMT.HLP
  90.  
  91.    b. If you are running OS/2 S3 video, have applied the service
  92.       pack (2.1) or have applied the manufacturing refresh (2.11),
  93.       the install program creates a new version of the following
  94.       files, but first saves the originals in *.PDP:
  95.         \OS2\SYSTEM\TRACE\SYSTEM.TDF
  96.         \OS2\SYSTEM\TRACE\SYSTEM.TFF
  97.         \OS2\SYSTEM\TRACE\SYSTEMD.TDF
  98.         \OS2\SYSTEM\TRACE\SYSTEMD.TFF
  99.  
  100.  
  101. DE-INSTALLATION INSTRUCTIONS
  102. ----------------------------
  103.  
  104. 1. Execute the "De-install" object in the "Problem Determination"
  105.    folder.
  106.  
  107.    Note:  the folder itself will not de-install if you have added
  108.    files to any of the paths within the PDP installation path or
  109.    if you have the path open in a window.
  110.  
  111.    Note:  the program does not touch the \OS2\DLL\PMMLE.DLL file,
  112.    the \CONFIG.SYS file, or the \PDPRun.Log.
  113.  
  114. 2. If you choose to delete the Problem Determination package manually:
  115.  
  116.    a. Copy the following hidden files on your boot drive then erase
  117.       the *.PDP files:
  118.  
  119.       Copy \OS2DUMP.PDP             to \OS2DUMP (hidden)
  120.       Copy \OS2\SYSLOG.PDP          to \OS2\SYSLOG.EXE
  121.       Copy \OS2\SYSLOGPM.PDP        to \OS2\SYSLOGPM.EXE
  122.       Copy \OS2\DLL\SYSLOG.PDP      to \OS2\DLL\SYSLOG.EXE
  123.       Copy \OS2\HELP\SYSLOGH.PDP    to \OS2\HELP\SYSLOGH.HLP
  124.       Copy \OS2\TRACE.PDP           to \OS2\TRACE.EXE
  125.       Copy \OS2\TRACEFMT.PDP        to \OS2\TRACEFMT.EXE
  126.       Copy \OS2\DLL\TRACEFMT.PDP    to \OS2\DLL\TRACEFMT.DLL
  127.       Copy \OS2\HELP\TRACEFMT.PDP   to \OS2\HELP\TRACEFMT.HLP
  128.  
  129.    b. Erase the following files on your boot drive:
  130.  
  131.       \OS2\SYSTEM\TRACE\TRC000A.TFF
  132.       \PDPKill.CMD
  133.       \PDPRun.Log
  134.  
  135.  
  136. COMPATIBILITY
  137. -------------
  138.  
  139. o  2.1 GA (debug, retail, HSTRICT)
  140.  
  141. o  2.1 S3 Video (debug, retail, HSTRICT)
  142.  
  143. o  2.1 Service Pack (debug, retail, HSTRICT)
  144.    2.11 Manufacturing Refresh (debug, retail, HSTRICT)
  145.  
  146. o  2.1 for Windows (debug, retail, HSTRICT)
  147.  
  148.  
  149. FUNCTIONAL RESTRICTIONS
  150. -----------------------
  151.  
  152. 1. If you install a new version of OS/2, you must re-install OS2PDP.
  153.  
  154. 2. Trace on/off icons in the Trace Options folder turn on/off all
  155.    trace points.  Execute Trace from the command line to set
  156.    specific trace points.
  157.  
  158. 3. Popup suppression and PDUMP fail for S3 video if you send the dump
  159.    to a HPFS partition.
  160.  
  161. 4. This package does not support the 2.0 dump formatters for GA,
  162.    Preload, Preload Backup, Service Pack, or Service Pack 2.
  163.  
  164. 5. Stand-Alone Dump Restrictions:
  165.  
  166.    Prompts and Messages
  167.    --------------------
  168.    a. Certain Video adapters do not switch properly into text mode from
  169.       Super VGA or XGA mode. Thus if a dump is initiated when in
  170.       graphics mode, no prompts will display.
  171.  
  172.       Video adapters with problem: Diamond Viper VLB
  173.                                    8514 on a PS/2 Model 80
  174.                                    XGA2 on a PS/2 Model 56/57
  175.  
  176.       NOTE: The dump is taking place. On dump to diskette, the beeps
  177.             will indicate when it is time to insert a diskette. When the
  178.             system beeps 3 times, please insert diskette #1 to update
  179.             the dump statistics.
  180.  
  181.       NOTE: To ensure that you know how to take a dump, initiate a trial
  182.             dump while in OS/2 full screen. The video adapter is already
  183.             in text mode and will display all prompts.
  184.  
  185.    OEM Systems
  186.    -----------
  187.    a. On many OEM systems such as Ambra, Value Point, and NCR, the dump
  188.       will begin to beep when accessing memory above 16 meg.  The
  189.       beeping has no effect on the dump itself, which completes
  190.       successfully.
  191.  
  192.    Systems with SCSI adapters
  193.    --------------------------
  194.    a. On OEM systems with SCSI adapters such as Future Domain, the dump
  195.       to hardfile may fail due to a problem with the SCSI adapter.
  196.       Depending on the circumstances that have required a memory dump,
  197.       if the SCSI adapter was very active at the time of the failure, it
  198.       may not have been allowed to complete its processing. The dump is
  199.       unable to access the hardfile in this situation.
  200.  
  201.    Miscellaneous
  202.    -------------
  203.    a. If there is a BAD sector on the disk, the dump to hardfile will
  204.       fail.
  205.    b. The dump to hardfile has no error recovery.
  206.    c. Dumping on 295 (two processors) is not supported.
  207.  
  208.  
  209. HOW TO REPORT PROBLEMS
  210. ----------------------
  211.  
  212. The package will be periodically refreshed.  If the package you
  213. are using is not the latest level, try to run on the latest package and
  214. see whether the problem is still there.  To report a problem use the
  215. following form as a template, filling in whatever is applicable, and
  216. return the completed form to Barry Bryan at address:
  217.  
  218. *   E-MAIL                USIB1L8T at IBMMAIL
  219.  
  220. *   CompuServe**          barryb@vnet.ibm.com
  221.  
  222. *   IBM Internal Users    BRYAN at BCRVM1
  223.  
  224. *   PRODIGY**             barryb@vnet.ibm.com
  225.  
  226. *   Fax                   (407)443-7785
  227.  
  228. *   U.S. Mail             IBM Corporation, 1430
  229.                           1000 NW 51st Street
  230.                           Boca Raton, FL 33431
  231.  
  232.  
  233. -------------------OS2PDP Problem Report (OS2PDP-0.2)-------------------
  234.  
  235. OS/2 Version____________________________________________________________
  236.  
  237. System Brand and Model__________________________________________________
  238.  
  239. Processor and Speed_____________________________________________________
  240.  
  241. System Memory Size______________________________________________________
  242.  
  243. Bus Type________________________________________________________________
  244.  
  245. Hard Disk Size and Type_________________________________________________
  246.  
  247. Video Adapter Brand, Model, and Chip Set________________________________
  248. ________________________________________________________________________
  249.  
  250. Problem Description_____________________________________________________
  251. ________________________________________________________________________
  252. ________________________________________________________________________
  253. ________________________________________________________________________
  254. ________________________________________________________________________
  255. ________________________________________________________________________
  256.  
  257.  
  258. -----------------End OS2PDP Problem Report (OS2PDP-0.2)-----------------
  259.  
  260.  
  261. TRADEMARKS
  262. ----------
  263. The following terms, denoted by an asterisk (*) in this file, are
  264. trademarks or registered trademarks of IBM Corporation in the United
  265. States and/or other countries:
  266.  
  267. IBM
  268. OS/2
  269.  
  270.  
  271. The following terms, denoted by an asterisk (**) in this file, are
  272. trademarks or registered trademarks of other companies as follows:
  273.  
  274.  
  275.  
  276. Trademark           Owner
  277. ------------------- ----------------------------------------------------
  278. CompuServe          CompuServe
  279. PRODIGY             Prodigy Services Co.
  280.  
  281.  
  282.  
  283.  
  284. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING
  285. WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  286. RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  287. DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  288.  
  289. THIS PACKAGE IS COPYRIGHTED BY INTERNATIONAL BUSINESS MACHINES
  290. CORPORATION.  ALL APPROPRIATE RESTRICTIONS APPLY.
  291.  
  292. (End of Document)
  293.  
  294.