Library Switches Determine Which C Libraries PWB Assumes

 Last reviewed: July 17, 1997
Article ID: Q74749
1.00 1.10 | 1.00 1.10 
MS-DOS    | OS/2
kbtool

The information in this article applies to:

  • Microsoft Programmer's Workbench for MS-DOS, versions 1.0 and 1.1
  • Microsoft Programmer's Workbench for OS/2, versions 1.0 and 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 reference words: kbinf 1.00 1.10 6.00 6.00a 6.00ax PWBIss
KBCategory: kbtool
KBSubcategory: PWBIss
Keywords : kb16bitonly

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: July 17, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.