home *** CD-ROM | disk | FTP | other *** search
/ Dr. CD ROM (Annual Premium Edition) / premium.zip / premium / IBMOS2_1 / MSVC_OS2.ZIP / READ.ME < prev   
Text File  |  1993-09-09  |  8KB  |  219 lines
  1. ===============================================================
  2. Instructions for Updating the Microsoft Visual C++ Command Line
  3. Tools to Run under OS/2 2.1
  4. ===============================================================
  5.  
  6. September 1, 1993
  7.  
  8. Phar Lap Software, Inc.
  9. 60 Aberdeen Ave.
  10. Cambridge, MA 02138
  11.  
  12. (617) 661-1510
  13. tech-support@pharlap.com
  14. FAX: (617) 876-2972
  15. BBS: (617) 661-1009  300-9600 Buad, 8 data, No parity, 1 stop
  16.  
  17. ====================================================================
  18.  
  19. This ZIP file contains a patch which allows the command
  20. line tools of Microsoft Visual C++ 1.0 for Windows to
  21. run in a DOS box of OS/2 2.1.  The Visual C++ compiler
  22. is a 16-bit compiler that targets DOS and Windows. The Visual
  23. C++ command line tools include CL, LINK, LIB, and NMAKE.
  24. The patch updates the DOSXNT DOS-Extender of Visual C++ to
  25. make it compatible with OS/2 2.1.  DOSXNT is a 32-bit
  26. DOS-Extender which was licensed from Phar Lap Software by
  27. Microsoft to run the Visual C++ command line tools.
  28.  
  29. Note:  This patch only allows the Visual C++ command line
  30. tools to be run in an OS/2 DOS box.  The patch does NOT
  31. allow the Visual Workbench to be run under OS/2.  Please
  32. see the Question and Answer section of this document
  33. for more information about the Visual Workbench.
  34.  
  35. To install the patch, you must already have installed
  36. Visual C++ 1.0 on your hard disk.  If you haven't already
  37. installed the compiler, do it now before proceeding.
  38.  
  39. Here are steps for applying the patch to Visual C++:
  40.  
  41. 1.  Start a DOS box under OS/2 2.1
  42.  
  43. 2.  Create a temporary directory on your disk and
  44.     make it the current directory:
  45.  
  46.         MD \OS2FIX
  47.         CD \OS2FIX
  48.  
  49. 3.  Using PKUNZIP, unpack this zip file in the
  50.     temporary directory:
  51.  
  52.         PKUNZIP OS2FIX.ZIP
  53.  
  54. 4.  Run the OS2FIX batch file.  For its command
  55.     line argument give the path to the top-level
  56.     directory which contains the Visual C++ compiler.
  57.     Example:
  58.  
  59.         OS2FIX C:\MSVC.100
  60.  
  61. 5.  The patch will take a few seconds to be applied.
  62.     If the patch is successful, the batch file will
  63.     print out a message saying it is done.  If there
  64.     is a problem applying the patch, then OS2FIX will
  65.     output a message saying what the problem is.
  66.  
  67. 6.  To clean-up, all of the files in the temporary directory
  68.     can be deleted and the temporary directory can be
  69.     removed:
  70.  
  71.         DEL *.*
  72.         CD ..
  73.         RMDIR OS2FIX
  74.  
  75. In order for DOSXNT to run correctly under OS/2, the DPMI
  76. support in OS/2 must be properly configured.  In particular, the
  77. "DPMI_DOS_API" DOS setting must be set to "enabled".  The default
  78. setting of "auto" will not work properly.
  79.  
  80. Here is how to set "DPMI_DOS_API" to enabled:
  81.  
  82. 1.  From the Command Prompts - Icon View window, double-click with the
  83.     right mouse button on the DOS Full Screen icon to bring up the menu.
  84.  
  85. 2.  Choose the "Open Settings" selection.
  86.  
  87. 3.  Click on the "Sessions" page button.
  88.  
  89. 4.  Click on the "DOS Settings" button.
  90.  
  91. 5.  At this point, a list of options is displayed.  Scroll to
  92.     "DPMI_DOS_API" and click on it to change the setting.  Select
  93.     "enabled" from the Value drop-down list and click on "OK."
  94.  
  95. 6.  Scroll to "DPMI_MEMORY_LIMIT" and click on it to change the setting.
  96.     This setting specifies the amount of DPMI memory available to the
  97.     DOS session.  OS/2 2.x supports between 0 and 512 MB of DPMI memory.
  98.     The default is 2 MB, which is not sufficient for most DOS-Extender
  99.     applications.  We use 10 MB; you should choose the appropriate value
  100.     for your program.  (There is no correlation between the amount of
  101.     DPMI memory and the amount of physical memory.)
  102.  
  103. 7.  Click on the "Save" button.  This brings you back to the DOS Full
  104.     Screen Settings window.
  105.  
  106. 8.  Close this window to return to the OS/2 desktop.
  107.  
  108. Once OS/2 has been properly configured we recommend compiling,
  109. linking, and running a simple test program to make sure that
  110. the Visual C++ compiler and the updated DOSXNT have been installed
  111. correctly.
  112.  
  113. Here are the basics for testing the compiler:
  114.  
  115. 1.  Double-click on the DOS Full Screen icon that has been
  116.     configured for running DPMI applications.
  117.  
  118. 2.  Make sure the PATH, INCLUDE, LIB, and TEMP environment
  119.     variables are properly configured for running the
  120.     Microsoft C/C++ compiler:
  121.  
  122.     SET PATH=C:\MSVC.100\BIN
  123.     SET LIB=C:\MSVC.100\LIB
  124.     SET INCLUDE=C:\MSVC.100\INCLUDE
  125.     SET TEMP=C:\TEMP
  126.  
  127. 3.  Build a simple test program like hello world:
  128.  
  129.         CL HELLO.C
  130.  
  131.     where HELLO.C contains
  132.  
  133.         main()
  134.     {
  135.         printf("Hello world....\n");
  136.     }
  137.  
  138. 4.  If the compile and link is successful, run the hello world
  139.     program:
  140.  
  141.     HELLO
  142.  
  143. 5.  All done!
  144.  
  145.  
  146. =====================
  147. Questions and Answers
  148. =====================
  149.  
  150. 1.  Why did the original version of DOSXNT.EXE that came with
  151.     Visual C++ not run under OS/2?
  152.  
  153.     The original version of DOSXNT.EXE required a Windows
  154.     Virtual Device Driver (VxD) in order to run in
  155.     Windows enhanced mode.  This VxD is named DOSXNT.386.
  156.     It provides enhanced memory management features not
  157.     found in either the Windows or the OS/2 DPMI servers.
  158.     Since OS/2 cannot run Windows VxDs, the original
  159.     version of DOSXNT was not compatible with OS/2 2.1.
  160.     The    newer version of DOSXNT was re-engineered by Phar
  161.     Lap Software to not use the VxD, hence it is compatible
  162.     with OS/2 2.1.
  163.  
  164. 2.  Why can't the Visual Workbench be used under OS/2 2.1?
  165.  
  166.     Since none of the Windows tools included with Microsoft Visual C++
  167.     1.0 for Windows have been tested on OS/2, Microsoft therefore
  168.     cannot guaruntee their functionality.  The Visual Workbench
  169.     specifically requires support of enhanced mode Windows
  170.     for it's build engine.   OS/2 doesn't provide this support and 
  171.     cannot be used to invoke builds from under OS/2.
  172.  
  173. 3.  Will the newer version of DOSXNT run under version 2.0 of
  174.     OS/2 in addition to version 2.1 of OS/2?
  175.  
  176.     Maybe, but all testing was done under OS/2 2.1 since it
  177.     is the currently shipping version of OS/2.  If you are
  178.     still running version 2.0 of OS/2 we recommend upgrading
  179.     to version 2.1.
  180.  
  181. 4.  Why can't I build Presentation Manager applications
  182.     which target OS/2 with Visual C++?
  183.  
  184.     The Visual C++ compiler only generates 16-bit code.
  185.     The compiler targets 16-bit DOS and 16-bit Windows.
  186.     Current generation Presentation Manager applications
  187.     require a compiler which generate 32-bit code.
  188.  
  189. 5.  Will Visual C++ 1.0 for Windows NT run under OS/2 2.1?
  190.  
  191.     The command-line tools appear to run under OS/2 but have
  192.     not been tested.  Therefore the support for these tools
  193.     is as mentioned in the next question.  Additionally the
  194.     Windows tools will not run because they are Windows NT
  195.     applications which won't run under OS/2.
  196.  
  197. 6.  Can I get technical support for Visual C++ when running
  198.     under OS/2?
  199.  
  200.     Yes, Microsoft Development Support will provide support
  201.     on the usage of the command-line tools but they cannot
  202.     address OS/2 specific issues.  Since the compiler has not
  203.     been extensively tested under OS/2, it is recommended
  204.     that if a problem with the tools occurs under OS/2
  205.     then it should be duplicated under DOS before calling 
  206.     Microsoft.
  207.  
  208. 7.  What about future versions of Visual C++ and other Microsoft
  209.     language products, will they be compatible with OS/2?
  210.  
  211.     This patch provided by Phar Lap Software does not represent
  212.     a commitment from Microsoft that future language products will
  213.     be able to run under OS/2.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.