                           Debug Readme

Files in this directory:

     ATTRIB.EXE   - Utility to change HIDDEN, READ-ONLY, SYSTEM attibutes
     DOSCALL1.DLL - Retail  DOS API Dynamic Link Library
     DOSCALL1.MAP - Retail  DOS API Dynamic Link Library Map File
     DOSCALL1.SYM - Retail  DOS API Dynamic Link Library Symbol File
     OS2KRNL.MAP  - Retail  Kernel Map File
     OS2KRNL.SYM  - Retail  Kernel Symbol File
     OS2KRNLB     - Hstrict Kernel
     OS2KRNLB.MAP - Hstrict Kernel Map File
     OS2KRNLB.SYM - Hstrict Kernel Symbol File
     OS2KRNLD     - Astrict Kernel
     OS2KRNLD.MAP - Astrict Kernel Map File
     OS2KRNLD.SYM - AStrict Kernel Symbol File
     OS2LDR       - Debug Version of OS2LDR
     OS2LDR.MSG   - Used with the Debug OS2LDR
     README.DBG   - This File

Files in the subdirectories below:

     _ASTRICT     - Astrict Kernel Trace Files
     _HSTRICT     - Hstrict Kernel Trace Files
     _RETAIL      - Retail  Kernel Trace Files


The Hstrict ("Half Strict") Kernel is basically the Retail kernel with the
addition of a kernel-based debugger.  It has minimal performance impact on
a system under test which is very important in a production environment.  This
is the debugger IBM recommends for general purpose use.

The AStrict ("All Strict") Kernel also contains the same kernel debugger as
the HStrict.  In addition, there are a number of runtime consistency checking
and debugging points added.  The addition of these assertions has a performance
impact on the system under test, which, though not usually dramatic, may be
noticable on an already busy system or may affect debugging of timing-
sensitive problems.  It is also common to encounter internal processing
errors (IPE's) using the AStrict Kernel.  These are the consistency checks
referred to above.  They are present in order to facilitate debugging the
Kernel itself, as well as device drivers and installable filesystems.
Finally, there are som kernel memory allocation ("heap") restrictions present
only in the AStrict Kernel.  IBM recommends only using the AStrict Kernel
when its use is mandated by the nature of a particular problem.

There is also a debug version of os2ldr.  This is normally used only for
problems in operating system memory allocation, including startup problems.
Its use is not generally recommended.  It is not necessary to use the debug
os2ldr if you use a debug kernel.

