DOCUMENT:Q70123  08-OCT-1999  [utilities]
TITLE   :PWB 1.1 Reads Environment Variables From .STS Files
PRODUCT :Microsoft Programming Utilities
PROD/VER::
OPER/SYS:
KEYWORDS:kb16bitonly

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

 - Microsoft Programmer's Workbench for MS-DOS 
 - Microsoft Programmer's Workbench for OS/2 
-------------------------------------------------------------------------------

SUMMARY
=======

Under Programmer's WorkBench (PWB) version 1.10, the settings for the
environment variables INCLUDE, LIB, and HELPFILES are stored in state (.STS)
files under the [environ] tag. (These settings were not stored in PWB version
1.00.)

When PWB starts, it will set its internal environment to the values in the .STS
file regardless of how the environment is set when you type "PWB".

This can be a special problem when starting PWB for the first time if you've
forgotten to run the NEW-VARS.BAT (or NEW-VARS.CMD under OS/2) batch file. In
this case, PWB records the null environment variables in the .STS file. When it
restarts, it will use the null values that were previously recorded in the .STS
file, even if you run the NEW-VARS file before starting PWB the second time. The
workarounds below work well in this situation, too.

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

Here is how PWB reads .STS files when it starts:

1. If a program list is set, PWB reads the environment information from the
   <program list>.STS file in the same directory as the program list.

2. If no program list is set, this information is read from the CURRENT.STS file
   in the INIT directory.

3. If no program list is set and no CURRENT.STS file exists, the environment is
   read from the DOS command shell.

Any changes to these three environment variables made with the MS-DOS Set command
will not be recognized in PWB if the CURRENT.STS or <program list>.STS
files exist.

The following are three possible ways of changing the INCLUDE, LIB, and HELPFILES
environment variables:

1. Modify the variables in the Environment dialog box under the Options menu in
   PWB.

2. Delete the .STS files.

3. Modify the environment variables under the [environ] tag in the .STS files.
   (Microsoft doesn't recommend doing this, but it can be done this way.)

Additional query words: kbinf 1.10 PWBIss

======================================================================
Keywords          : kb16bitonly 
Technology        : kbAudDeveloper kbPWBSearch kbZNotKeyword3
Version           : :

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

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.