  IBM VisualAge(R) C++ Professional for OS/2(R), Version 4.0 - INSTALL
  -------------------------------------------------------------------

IBM VisualAge(R) C++ Professional for OS/2(R), Version 4.0
  (C) Copyright IBM Corporation 1991, 1998 - All Rights Reserved.

  US Government Users Restricted Rights - Use, duplication or disclosure
  restricted by GSA ADP Schedule Contract with IBM Corp.

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


Trademarks

The following terms are trademarks of International Business Machines
Corporation in the United States or other countries or both:

    IBM
    DB2
    Open Class
    OS/2
    VisualAge

Other terms used in this README, which may be denoted by a double
asterisk(**), are trademarks or service marks of others.


Contents
========

HARDWARE REQUIREMENTS
SOFTWARE REQUIREMENTS
PREREQUISITES
INSTALLING THE PRODUCT
INSTALLING ADDITIONAL COMPONENTS
KNOWN INSTALLATION PROBLEMS
SILENT INSTALLATION (not supported)
UNINSTALLING THE PRODUCT

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

HARDWARE REQUIREMENTS
_____________________

   o Processor:
     - Pentium 166, or higher, or compatible processor recommended
   o Display:
     - SVGA, 800x600 (1024x768 and 64K colors recommended)
     - Note: On machines using a Western Digital WD90C24 or WD90C33
       video adapter, such as the IBM Thinkpad 755CX, running at 
       800x600x64K colors causes the IDE to be transparent. You must
       run the adapter at 256 colors. This will cause interference
       problems with the palettes of other applications such Netscape.
     - We have experienced problems with some newer S3 video cards. For example, 
       using the S3 Trio 3D (**) video card with our Integrated Development 
       Environment can cause your system to hang. For the latest information 
       on this problem, please contact IBM VisualAge C++ Support.
   o CD-ROM drive - for installation only
   o Mouse or pointing device
   o Memory requirements:
     - 96MB RAM minimum, 128MB RAM recommended
   o Disk space requirements (in MB):
     - Installing the default choices requires 440MB on an HPFS partition
     - A full install, of all components, will require approximately
       630MB on an HPFS partition.  Requirements on a FAT partition 
       will depend upon the partition size.
   o Swap/paging space:
     - 75MB minimum, 100MB recommended.  You may need to reserve more,
       depending on the size of your application.

   NOTES:

       o When planning disk usage for this product, space should be
         allocated for the Codestore (ICS) files produced by the C++
         compiler.  As a guide, it is recommended that you reserve 10MB
         of disk space required for any large or complex project. You may
         need more or less space depending on the amount of header
         file data that is being compiled.  For example, including large
         amounts of IBM Open Class header files or OS/2 Toolkit header
         files can cause a larger ICS file to be produced than if the
         application uses smaller, self-contained header files.

       o In the Integrated Resource Editor (IRE), when using some S3 
         display drivers with colors set to more than 256, the "New 
         Dialog/Window" dialog bitmaps appear in black and white.



SOFTWARE REQUIREMENTS
_____________________

   o Applications built with VisualAge C++ Version 4.0 run on OS/2 Version 4.0
   o VisualAge C++ Version 4.0 runs on OS/2 4.0 with the fix for APAR JR10138 applied. 
     - For US English OS/2 users, this is included with Fixpak 8 (XR_M008). A zipped
       version of this fixpak is included on the English version of the VisualAge C++
       Professional for OS/2, Version 4.0 CD in \OSFIXPK\xr_m008.zip.
     - For Japanese OS/2 users, you must install Fixpak 5 (FX00505),  A zipped version 
       of this fixpak is included on the Japanese version of the VisualAge C++ 
       Professional for OS/2, Version 4.0 CD in \OSFIXPK\fx00505.zip. Apply the patch 
       by running the JR10138.CMD file (also found in this directory), after FX00505 
       has been installed.
     - For Simplified Chinese OS/2 users, you must install Fixpak 5 (FX00505). Contact OS/2
       support for a Simplified Chinese patch for JR10138, and then apply this patch on
       top of FX00505. 
     - For other National Language versions of OS/2, install the latest fixpaks, 
       available from http://service5.boulder.ibm.com/pspfixpk.nsf/, and contact OS/2
       support for patches for JR10138.


PREREQUISITES
_____________

   o A frames-capable browser to install the product, and to access the HTML-based 
     help. Netscape Navigator (**) Version 4.04 (for OS/2) is included on the CD.

   o TCP/IP communication protocol

   o To use the Data Access Class Builder you need:
     - A database with the appropriate ODBC database driver, or
     - DB2/2 Version 2.1.2 or higher

   o Help System Requirements
   - TCP/IP must be installed and configured for OS/2:
     1)For a LAN adapter configuration:
       - You must have DNS enabled with a valid host and domain name.
       - Your LAN DNS must resolve "localhost" to 127.0.0.1
       - You cannot run disconnected with a LAN adapter configuration.
     2)For a Dial-Up Adapter configuration:
       - You must have DNS disabled.
       - Your TCP/IP Address must be obtained automatically.
       NOTE: These configuration options will apply to all TCP/IP
       adapters even though they have only been changed for this one.
       You will not be able to use both LAN and Dial-Up without
       reconfiguring.


INSTALLING THE PRODUCT
______________________

 o If you have installed the Beta for IBM VisualAge C++ Professional
   for OS/2, Version 4.0, you must uninstall the Beta before installing
   the final release of the product.

 o Before you can install IBM VisualAge C++ Professional for OS/2,
   Version 4.0, you must have installed Netscape Communicator (**) 
   Version 4.04 (for OS/2), and the installation runtime code installed.
   This runtime code is called Feature Installer. It is shipped on this 
   CD, and on the IBM C/C++ Compilers Version 3.6.5 CD. It need only be 
   installed once. Feature Installer requires a version of Netscape to 
   be installed before Feature Installer can be installed. If you do not
   already have Netscape Navigator 2.02, or Netscape Communicator 4.04 
   installed, click on "Install Netscape Communicator 4.04 from the
   main installation menu. Follow the instructions. You must reboot after
   installing Netscape Communicator.   To install Feature Installer, 
   choose the "Install the Installation Program" item from the main
   installation window. After Feature Installer has installed, you must
   reboot your machine.

   The level of Feature Installer on this product is 1.23.

   If you have installed IBM VisualAge for Java for OS/2, Version 1.0 
   (any edition), or IBM C/C++ Compilers for OS/2 3.6 (not the 3.6.5 CD 
   included in this product), which uses Feature Installer level 1.21, 
   you must re-install Feature Installer.

   If you have installed IBM VisualAge for Java for OS/2, Version 2.0 
   (any edition), which uses Feature Installer level 1.22, you must 
   re-install Feature Installer.

   If you have installed the IBM C/C++ Compilers, Version 3.6.5 CD, which 
   uses Feature Installer level 1.23, you do not have to re-install Feature Installer.

   If you have installed an OS/2 Fixpak since installing Feature Installer
   level 1.23, you must re-install Feature Installer.

   To install Feature Installer 1.23, select the "Install The Installation
   Program".  After installing Feature Installer, you should reboot, then 
   restart the Meta Installer.

 o You can start the Meta Installer by entering the following command:

   x:\install.exe

   where x is the CD-ROM drive.

   From the Meta Installer, you can view the INSTALL.TXT file (this file),
   the README.TXT file, and the UPDATES.TXT file. It is also used to 
   install Feature Installer, the product installation tool, and lastly 
   to install the product. 

 o You must have installed a version of the OS/2 Toolkit headers and 
   libraries, and (depending on the features you use) the OS/2 Toolkit tools, 
   before you can perform any builds with the VisualAge C++ product.
   You must either install the Toolkit from the CD, from the IBM C/C++ 
   Compilers, Version 3.6.5 CD, or have installed it separately.  The toolkit 
   on this CD is a subset of the 970925.1 level of the toolkit available
   from http://www.developer.ibm.com/devcon/.

o During the installation of the product Netscape is used as a user interface
  for the install program. The Netscape window cannot be moved, resized, minimized, 
  maximixed or closed during the installation. Only double-clicking of the 
  System Menu (upper left hand Netscape Icon) will close the Netscape window.

o If you are installing both the IBM C and C++ Compilers, Version 3.6.5 CD and
  the VisualAge C++ Professional for OS/2 Version 4.0 CD, there are two possible
  ways to install the OS/2 Toolkit. In both cases, install the OS/2 Toolkit when
  installing from the first CD. Note that the order of installation is generally not
  important, but we recommend that you install the IBM C and C++ Compilers,
  Version 3.6.5 CD first.
 
  The easiest way is to choose to install the OS/2 Toolkit for the 4.0 CD is to select
  it, and to target the TOOLKIT directory to be the same as that used in the 3.6.5
  CD. The installation will incorrectly report that you need about 100M more than
  you really do on the drive where the Toolkit will be installed. If you have enough
  space on this drive, then proceed. If you do not have enough space, then do not select to install the OS/2 Toolkit
  from the 4.0 CD. 

  Once the install has completed, you will need to copy a file from
  CD to your hard drive where you installed the second product. In this example,
  G:\ is assumed to be the location that you are installing from, D:\IBMCPP the
  location where you installed the product to, and E:\TOOLKIT is the location that
  you installed the OS/2 Toolkit to when you installed the 3.6.5 CD. 
  COPY G:\VACPP\BIN\SETENVTK.CMD
  D:\IBMCPP40\BIN\SETENV.CMD
  Edit the D:\IBMCPP40\BIN\SETENV.CMD
  
  Change:
  SET VACPPMAIN=X:\XYZ_XYZ to SET VACPPMAIN=D:\IBMCPP40
  SET TKMAIN=X:\XYZ_XYZ to SET TKMAIN=E:\TOOLKIT
 
  If you are installing the Japanese or Chinese version of the product change
  SET LANG=en_us to SET LANG=ja_jp or SET LANG=zh_cn respectively. 
 

o When you are assigning target drives and directories, you will always see 
   entries for:
     Install samples (on)
     Install OS/2 Toolkit (on)
   even if you choose not to install them. You do not have to change these 
   values if you have not selected these components.

o The VisualAge C++ Version 4.0 product installation process requires
   some temporary disk space on your OS/2 boot drive. In addition, the 
   installation can require up to 100M of swap space.If you do not have
   enough space, you will see a message that there is not enough space,
   and the installation process will terminate. Correct this, and restart
   the installation process. There are two LOG files:
   \OS2\INSTALL\CURRENT.LOG, and \OS2\INSTALL\WPINSTAL.LOG which are
   appended to by each invocation of Feature Installer, and can be deleted to 
   save some space. 

 o You will be asked during the install if you want to configure your
   Netscape Browser. We recommend that you choose "yes". If not, you must
   configure TCP/IP and Netscape manually as described above. If you access 
   the internet through a proxy server, and you re-install your browser or 
   change to a new version of the browser after you install VisualAge C++,
   you may need to reconfigure your browser so that "localhost" is a proxy 
   exception in the browser. 

 o If your installation fails, check \OS2\INSTALL\CURRENT.LOG and
   \OS2\INSTALL\WPINSTAL.LOG for the reason why the installation failed.

 o You must reboot your machine after VisualAge C++ Version 4.0 has 
   been installed.

INSTALLING ADDITIONAL COMPONENTS
________________________________

Once VisualAge C++ has been installed, you can only install additional 
components by reinstalling. Follow these steps: 

1. Insert the IBM VisualAge C++ Professional for OS/2, Version 4.0 
   CD-ROM into the CD-ROM drive. 

2. Open the CD-ROM directory. 

3. Double-click install.exe. 

4. Choose Install VisualAge C++ Version 4.0 and proceed to the feature
   selection panel. 

5. Select the features you wish to add to your original installation, and
   reselect those features which you originally installed. Then click Next.
   Note that the installer does not remember which features have already 
   been installed. 

6. Ensure that you select the same target drives and directories as you 
   did in the original installation. 

7. Follow the instructions to complete the installation. 


KNOWN INSTALLATION PROBLEMS
___________________________

 o Feature Installer must not be installed on a system with OS/2 4.0 FixPak 
   3 installed. We recommend that you install Fixpak 8, which is installed 
   on the CD.

 o The third HTML page of the install allows you to change 
   drives and directories. Select the drive to install first, followed by 
   the directory on this page. If you select the directory first, then click 
   on the background of the page outside the entry before selecting the drive
   to refresh the page. This will avoid a possible trap during the install.



SILENT INSTALLATION
___________________

 Silent Installs are not supported in this product.


UNINSTALLING THE PRODUCT
________________________

 o Because the OS/2 Toolkit may have already been on your system, from IBM
   C/C++ Compilers, Version 3.6.5 or from a Developer's Connection, it will not 
   be removed from your system if you do an uninstall of VisualAge C++ Version 4.0.

 o At the end of an install, only those files which have not changed since the
   install will be deleted. To completely clean up the system, remove the
   \IBMCPP40 directory after you reboot.

 o You must reboot after uninstalling any version of the product.
