DOCUMENT:Q72391  13-JUN-2001  [utilities]
TITLE   :BUG: Cannot Open MASM 6.0 Sample Programs from PWB Online Help
PRODUCT :Microsoft Programming Utilities
PROD/VER::1.0,1.1,2.0,2.1.49
OPER/SYS:
KEYWORDS:

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

 - Microsoft Programmer's Workbench for MS-DOS, versions 1.0, 1.1, 2.0, 2.1.49 
-------------------------------------------------------------------------------

SYMPTOMS
========

Attempting to access the Microsoft Macro Assembler (MASM) version 6.0 sample
help programs through the Programmer's WorkBench (PWB) version 1.00 or 1.10
online help system will generate an error. For example, the following message
results from trying to view the file C.ASM:

   Cannot open [$ASMEX:MIXED\C.ASM]: Not found

Selecting any one of the sample programs should cause a copy of the program to be
loaded into the help window, but the DOS version of PWB generates the above
message instead.

RESOLUTION
==========

The following three methods may be used to work around this problem:

1. Change directories to the MASM 6.0 samples subdirectory (by default, this is
   C:\MASM\SAMPLES). This can be easily accomplished if the ASMEX environment
   variable has been correctly set to point to your samples directory. Choose
   Open on the File menu and type in "$ASMEX:" (without the quotation marks) and
   press ENTER. Next, choose Cancel to return to the editor. Attempts to access
   sample program files from the online help will now be successful as long as
   you do not change the current directory.

- or -

2. Load the file directly into the editor. The programs will be in one of four
   subdirectories under the MASM 6.0 samples directory: \DEMOS, \TSR, \MIXED, or
   \SHOW. Choose Open on the File menu, and then there are three ways to open
   the sample files:

   a. Switch to the directory of the desired example file by using the dialog
      box controls and then select the desired file.

   b. Enter the full path name of the file and press ENTER, for example:

   C:\MASM\SAMPLES\MIXED\C.ASM

   c. Use the ASMEX environment variable to specify the path to the file, for
      example:

   $ASMEX:MIXED\C.ASM

- or -

3. Access the online help through the QuickHelp utility. The sample help files
   are correctly located by QuickHelp.

STATUS
======

Microsoft has confirmed this to be a bug in the products listed at the beginning
of this article.

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

To reproduce this error, follow these steps:

1. Choose Contents on the PWB Help menu.

2. Choose Assembly in the "Languages" section of the main "Microsoft Advisor
   Help System" screen.

3. Choose Example Code in the "Related Programs" section of the "MASM 6.00
   Contents" help screen.

4. Choose Mixed Languages from the "Example Code" selection screen.

5. Choose a file, such as C.ASM, and the above error will be displayed.

Additional query words: 1.00 1.10 2.00 2.10.49

======================================================================
Keywords          :  
Technology        : kbAudDeveloper kbPWBSearch kbZNotKeyword3 kbPWB100DOS kbPWB110DOS kbPWB200DOS kbPWB2149DOS
Version           : :1.0,1.1,2.0,2.1.49

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

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 2001.