How to Enable Debug Message Output During Setup

Last reviewed: March 2, 1998
Article ID: Q139340
3.51 WINDOWS kbsetup kbtshoot kbhowto

The information in this article applies to:

  • Microsoft Windows NT Workstation version 3.51
  • Microsoft Windows NT Server version 3.51

SUMMARY

During Setup, it is possible to display debug information. This is controlled by changing the value of the DEBUGOUTPUTCONTROL variable located in either the INITIAL.INF or SETUP.INF file (depending on the type of Setup used).

MORE INFORMATION

You can determine whether or not debug information is displayed by changing the value of the variable, DEBUGOUTPUTCONTROL. If this variable is set to 1, debug messages are displayed; if it is set to 0, debug messages are suppressed. There are two ways to set or clear DEBUGOUTPUTCONTROL.

GUI-MODE SETUP

GUI-mode Setup is controlled by INITIAL.INF, which contains a [DebugVars] section. The variable, STF_DISPLAYDEBUGOUTPUT, is defined by the following:

   [DebugVars]
   STF_DISPLAYDEBUGCONTROL = 0

To display debug output, change the 0 to 1. This causes debug messages to be displayed because in the shell section of INITIAL.INF, the value of STF_DISPLAYDEBUGCONTROL is assigned to DEBUGOUTPUTCONTROL as follows:

   read-syms DebugVars
   set !DebugOutputControl = $(!STF_DISPLAYDEBUGOUTPUT)

MAINTENANCE-MODE SETUP

An acceptable and more direct method is to set DEBUGOUTPUTCONTROL directly. SETUP.INF contains a statement which sets the value of DEBUGOUTPUTCONTROL. To display debug information, change the 0 to 1, as shown in the example below:

   set !G:DebugOutputControl = 0

In maintenance Setup mode, this is the only available method because SETUP.INF controls maintenance-mode Setup (INITIAL.INF is not used) and SETUP.INF does not have a [DebugVars] section.

NOTE: The use of the "G" prefix sets the value of DEBUGOUTPUTCONTROL in tth global symbol table in case SETUP.INF is not the top level .INF file.


Additional reference words: prodnt 3.51 debugref
Keywords : nthowto kbhowto kbsetup kbtshoot
Version : 3.51
Platform : WINDOWS


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: March 2, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.