DOCUMENT:Q74749  30-OCT-1999  [utilities]
TITLE   :Library Switches Determine Which C Libraries PWB Assumes
PRODUCT :Microsoft Programming Utilities
PROD/VER:MS-DOS:1.0,1.1; OS/2:1.0,1.1
OPER/SYS:
KEYWORDS:kb16bitonly

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Programmer's Workbench for MS-DOS, versions 1.0, 1.1 
 - Microsoft Programmer's Workbench for OS/2, versions 1.0, 1.1 
-------------------------------------------------------------------------------

SUMMARY
=======

PWB uses library switches in the TOOLS.INI file to determine whether certain
libraries have been installed and whether to assume explicit or default names
for each type.

MORE INFORMATION
================

The library switches are as follows:

   Switch         C Libraries Affected
   ------         --------------------
   doslibs        MS-DOS libraries
   os2libs        OS/2 libraries
   winlibs        Windows libraries
   dlllibs        OS/2 DLL libraries
   windlllibs     Windows DLL libraries
   mtlibs         OS/2 Multithreaded libraries

These switches should be set to either explicit, default, or none, depending on
how the libraries were named during the install process. The Setup program
places the correct settings in the TOOLS.PRE file in a section with the
[pwb-pwbc] tag. This tagged section should be placed in your TOOLS.INI file and
updated whenever any changes are made to the installed libraries.

Further information for the library naming convention can be found under any of
these switch names in the online help.

If the library switch for a particular library type is set to default, then
attempting to select the explicit library name will not work as expected. For
example:

1. Set doslibs to default in TOOLS.INI.

2. Start PWB.

3. Choose C Compiler Options from the Options menu.

4. Choose MS-DOS in the C Libraries section of the C Compiler Options dialog box
   and select OK.

When you subsequently check the setting of C Libraries, it will be reset to
Default, even though it was just changed to MS-DOS. This is because doslibs is
set to default and cannot be overridden in this manner.

If the library switch for a particular library type is set to none, then
attempting to select a library of that type (either through Set Initial Build
Options under Build Options on the Options menu or through C Libraries under C
Compiler Options) will result in the following dialog box:

    ----------- C Libraries Error -----------
   |                                         |
   |      <type> library not installed       |
   |      Assume explicit library name?      |
   |                                         |
   |-----------------------------------------|
   |   < Yes >  <  No  >  <Cancel>  < Help > |
    -----------------------------------------

<type> can be either MS-DOS, OS/2, Windows, OS/2 DLL, Windows DLL, or OS/2
Multithreaded. Selecting Yes will assume explicit names; selecting No will
assume default names.

To avoid these situations, verify that library switch settings in the TOOLS.INI
are correct for the libraries currently installed and the naming convention
used.

Additional query words: kbinf 1.00 1.10 6.00 6.00a 6.00ax PWBIss

======================================================================
Keywords          : kb16bitonly 
Technology        : kbAudDeveloper kbPWBSearch kbZNotKeyword3 kbPWB100DOS kbPWB110DOS kbPWB100OS2 kbPWB110OS2
Version           : MS-DOS:1.0,1.1; OS/2:1.0,1.1

=============================================================================

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.

Copyright Microsoft Corporation 1999.