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.