README - IBM(R) VisualAge(R) for Java(TM), Rollup2 ======================================================================= This document provides information on Rollup2 for VisualAge for Java, Version 2.0, on Windows 95/98, Windows NT, and OS/2. DESCRIPTION ======================================================================= Rollup2 contains the following: - All fixes previously issued in Rollup1 - Additional defect fixes - JDK 1.1.7A support, which includes euro currency capability - JFC 1.0.3 support - Windows 98 support FILES ======================================================================= rollup2_vaj20_xxx.zip (where xxx is win or os2) CONTENTS ======================================================================= Part 1 - System Prerequisites and Redistributable Files/Modules Part 2 - Installing Rollup2 for the First Time Part 3 - OS Upgrades for Euro Support Part 4 - Recovery Instructions Part 5 - Components Testing and Certification Part 6 - Known Problems PART 1 - SYSTEM PREREQUISITES AND REDISTRIBUTABLE FILES/MODULES --------------------------------------------------------------- PART 1A - SYSTEM PREREQUISITES * The client software and hardware prerequisites are the same as specified for VisualAge for Java, Version 2.0, except for the following: - Ensure that there is at least 40 MB of free disk space on the drive where VisualAge for Java is installed. This is required for VisualAge for Java to finish the Rollup2 install. PART 1B - REDISTRIBUTABLE FILES/MODULES None of the files/modules included in Rollup2 are redistributable. PART 2 - INSTALLING ROLLUP2 FOR THE FIRST TIME -------------------------------------------------- If you are installing Rollup2 for the first time, then follow the instructions in parts 2A and 2B below. PART 2A - PREPARING TO INSTALL ROLLUP2 Rollup2 can be applied to any national language version of VisualAge for Java, Version 2.0. Rollup2 will install itself over your existing copy of VisualAge for Java, Version 2.0. Make sure a copy of VisualAge for Java, Version 2.0 is already installed. Note: As part of the installation of this rollup, the workspace will be replaced. This new workspace will only have the System Projects added. Workspace Recovery will rebuild the workspace by adding all the user's projects that were in the workspace before the rollup was applied. The user's projects (and all their contents) will be at the exact version/edition level they were at prior to installing the rollup (including all tool data). Workspace Recovery will NOT recover Scrapbook contents or Visual Composition Editor contents. PART 2B - INSTALLING ROLLUP2 1. Prepare for the rollup * If you are planning to apply new Enterprise connectors downloaded from VADD, you must do so before applying Rollup2. * Save any Scrapbook pages. * Save any open Visual Composition windows. * Exit the workspace by choosing File -> Exit VisualAge... Note: If you do not want Workspace Recovery to rebuild your workspace, then at this point you should version all of your projects and delete them from the workspace. 2. Unzip rollup2_vaj20_xxx.zip (where xxx is win or os2) into the directory created when VisualAge for Java was originally installed. Unzip rollup2_vaj20_xxx_pre.zip into the same directory. Unzip should be set to OVERWRITE existing files of the same name and path. 3. Run VisualAge for Java. VisualAge for Java will now finish the installation. If the required disk space is not available (as mentioned in PART 1A), the installation will fail. If this occurs, more free space must be created on the disk drive. Once there is sufficient space, go back and unzip rollup2_vaj20_xxx.zip as in step 2. Re-run VisualAge for Java. If there were User Projects in the workspace before the rollup was installed, Workspace Recovery will rebuild the workspace. A dialog will appear with the following text: The Workspace is not consistent with the Repository. Attempting to rebuild the Workspace. Please wait... Note: The process could take a few minutes, depending on the amount of work in the workspace before the rollup was applied. 4. Confirm that the rollup has been applied properly. Help -> About VisualAge In the dialog, the third line should read: 2.0,(NC) 12/4/98 IV2-2 5. Save the workspace before continuing. * Select File -> Save Workspace. * Click OK. * Keep a copy of the workspace file INSTALLDIR/ide/Program/IDE.icx. PART 3 - OS UPGRADES FOR EURO SUPPORT ------------------------------------- 1. To display the Euro currency symbol, you may need to upgrade the operating system as follows: * Windows NT 4.0 users should download and run the 'NT 4.0 euro product update' available from http://microsoft.com/windows/euro.asp * Windows 95 users should download and run the 'Final Windows 95 product update' available from http://microsoft.com/windows/euro.asp * OS/2 users should download the appropriate fixpack from http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs- usa/softupd.html 2.a. For SBCS languages for Windows, do the following: * Run VisualAge for Java. * Select Window -> Option. * Select Appearance. * Select Source and change the font to Courier New. * Click OK. 2.b. For SBCS languages for OS/2, do the following: * Run VisualAge for Java. * Select Window -> Option. * Select Appearance. * Select Source and change the font to Times New Roman. * Click OK. PART 4 - RECOVERY INSTRUCTIONS ------------------------------ Note: These instructions describe how a user can recover from a corrupt workspace once they have installed the rollup. If the workspace gets into a state where 1) the product will not start; 2) the workspace file seems to grow indefinitely; 3) the product behaves in some other degenerate way; then delete the workspace file INSTALLDIR/ide/program/ide.icx, and use the saved copy of the ide.icx workspace file (see INSTALLATION, PART 2B). You will then be able to reload your work from the repository. PART 5 - COMPONENTS TESTING AND CERTIFICATION --------------------------------------------- The following components have been tested with Rollup2: Component Completely tested with Rollup2 ========= ============================== Data Access Beans Yes SCM I/F Yes JDBC-ODBC Bridge Yes Notes Agent Runner No * JSP Tooling Yes Help Yes HPJ Yes ET/400 Yes ET/390 Yes RMI Yes EAB No * SAP Yes Team Support Yes * Initial testing is complete; additional testing is ongoing. Components not listed here may run without problems with Rollup2 installed, but final certification testing has not yet been completed. PART 6 - KNOWN PROBLEMS ------------------------ 1. Trying to connect to a non-existing SAP system causes a trap of VisualAge for Java (Windows). If you try this outside of VisualAge for Java with JDK 1.1.7, the Java VM will trap. Other unpredictable results may also happen on OS/2. Use only valid connections. A SAP R/3 Access Builder fix will be made available in the future. 2. Possible exceptions under OS/2: In certain circumstances, Access Builder for SAP R/3 displays exceptions in the console. Disregard the exceptions; continue your work. An Access Builder for SAP R/3 fix will be made available in the future.