IBM VisualAge Generator V4.5 FixPak1 Readme

This VisualAge Generator V4.5 FixPak1 Readme file contains the latest installation instructions, product support, and limitation information.

Product Enhancements, Problem Support, and Limitations

Java Performance Improvements

• A number of enhancements have been made to VAGen Developer on Java resulting in substantial performance improvements in a number of areas.  In general, reading VAGen parts from the library will be faster.  Performance has also been improved in the following specific areas:

- Opening a program in the Program Editor
- Expanding the Program Editor structure diagram and specifications nodes
- Open a record or table containing many shared data items
- Loading a program in the Test Facility and running it for the first time

VAGen Java API updates

With this FixPak, the signatures of several VAGenUtilityInterface APIs have changed. Current users of the APIs will need to change their code. In addition, new APIs to add menu items to the Packages menu of the VAGen Parts Browser have been added, and a new interface has been added which provides a means for executing code when the product is started.
• The following APIs have been replaced:
  public static boolean addPartNameValidationHandler(String handlerClassName)
  public static boolean removePartNameValidationHandler(String handlerClassName)
  public static boolean addPartsMenuItem(String itemName, String listenerClassName, int enabled)
  public static boolean addPartsMenuItem(String itemName, String listenerClassName, String enablerClassName)
  public static boolean addToolsMenuItem(String itemName, String listenerClassName)
  public static boolean addToolsMenuItem(String itemName, String listenerClassName, String enablerClassName)


• The new APIs are as follows:
  public static void addPartNameValidationHandler(VAGenPartNameValidationHandler handler)
  public static boolean removePartNameValidationHandler(VAGenPartNameValidationHandler handler)
  public static void addPartsMenuItem(String itemName, VAGenActionListener listener, int enabled)
  public static void addPartsMenuItem(String itemName, VAGenActionListener listener, VAGenActionEnabler enabler)
  public static void addToolsMenuItem(String itemName, VAGenActionListener listener)
  public static void addToolsMenuItem(String itemName, VAGenActionListener listener, VAGenActionEnabler enabler)


• Previously a class name was passed in and an instance of the class was created automatically. Now an instance of the class must be created and passed as an argument. In addition, name validation handlers and additional menu items are no longer retained between product sessions. See below for information on how the VAGenStartupClass interface can be used to execute code each time the product is started.


• The following APIs have been added to allow the addition of menu items to the Packages menu of the VAGen Parts Browser.
  public static void addPackagesMenuItem(String itemName, VAGenActionListener listener, int enabled)
  public static void addPackagesMenuItem(String itemName, VAGenActionListener listener, VAGenActionEnabler enabler)
  public static void addPackagesMenuSeparator(String separatorName)
  public static boolean removePackagesMenuItem(String itemName)

List of APARs

 
JAVA :
• PQ43226 - PERFORMANCE IMPROVEMENTS FOR VISUALAGE GENERTOR DEVELOPER 4.5

PQ42011 - VISUALAGE GENERATOR COBOL PROGRAMS USING MQ DO NOT CALL THE CORRECT RUNTIME MODULES.
PQ43227 - MSL Migration on Java - you can save the sandbox, but when restored status info is lost
PQ42561 - EXECMODE ESF ATTRIBUTE NOT EXPORTED FOR VISUALAGE GENERATOR PROGRAM.
PQ43228 - Import of duplicate parts using the Defined option causes Image and Parts Browser to become out of sync.
PQ42091 - User gets a KSH not found error when trying to start the prep on OS390.
PQ43235 - COMMAND FILE TO EXECUTE VISUALAGE GENERATOR LAN AND BATCH GENERATIONS CONTAINS ERRORS.
PQ42906 - EXECUTING HPTCNV45 RESULTS IN DLL NOT FOUND ERROR FOR PROGRAM CSO40API.
PQ42637 - CALL CREATX and AUDIT FAIL VALIDATION WITH error 753.E.
PQ42096 - COBOL Generation fails when a first UI or first map contains an edit routine invoking other functions
PQ43352 - Incorrect EZERTN behavior for I/O option

VisualAge Generator 4.5 FixPak1 Installation Notes

• Before installing FixPak1, you must first unload ALL of the VisualAge Generator features from your workspace and close the product saving the workspace. The order to unload the features is very important, so please make sure that you delete the features in the following order:
  1. VisualAge Generator Templates QuickStart (if you have this feature loaded)
  2. VisualAge Generator Templates (if you have this feature loaded)
  3. VisualAge Generator Utilities
  4. Shut down the product, then bring it back up. (Note: Product must be taken down and restarted if any other VisualAge Generator features are deleted before the "VisualAge Generator" feature.)
  5. VisualAge Generator
  After ALL VisualAge Generator features are unloaded, shut down the product.
• Download and run VAGenDevJavaFP1.EXE from the FTP site ftp://ps.software.ibm.com. This site contains information and fixes for a wide variety of other IBM products. The files for FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.5/FixPak1/windows. You may perform an anonymous logon to this FTP site.
• After installation, you need to add the VisualAge Generator V4.5 features, which now are called "...4.5 + FP1". Then close the product and bring it back up.
• If after the installation when you bring up the Developer an error message appears complaining about corrupted workspace, your workspace IDE.icx is corrupted. This is mostly due to that you didn't unload all the VisualAge Generator features from the workspace before installing FixPak1. To work around this, do the following:
1. Shut down Developer.
2. Find the IDE.ZIP file on the VisualAge for Java installation CD in directory ivj35\backup, unzip the IDE.ICX file to IDE\program directory under the VisaualAge for Java install directory (e.g, if you installed VAJava in c:\IBMVJAVA, then unzip it to c:\IBMVJAVA\IDE\Program). This should restore a clean workspace.
3. Delete the file IDE\program\projects.sav.
4. Bring up Developer, the IDE now should reconstruct the workspace from the repository.

VisualAge Generator Redbook