IBM VisualAge Generator Templates Customizer Version 4.0 fixpak 3 Readme ------------------------------------------------------------------------ Table of Contents Introduction Product Enhancements to the VisualAge Generator Templates Customizer Product for Version 4.0 fixpak 3 * Enhancement of the Browsers * Generated Web client * Generation Improvement Limitations and Known Problems Installation * Preparing for Installation * Installing VisualAge Generator Templates Customizer on Java * Installing VisualAge Generator Templates Customizer on Smalltalk ------------------------------------------------------------------------ Introduction *This VisualAge Generator Templates Customizer V4.0 fixpak 3 Readme file contains information about installing VisualAge Generator Templates Customizer V4.0 fixpak 3. This fixpak applies to Visual Age Generator Templates Customizer On Java and On Smalltalk. This Readme highlights the latest enhancements to VisualAge Generator Templates Customizer. ------------------------------------------------------------------------ Product Enhancements to the VisualAge Generator Templates Customizer Product for Version 4.0 fixpak 3 VisualAge Generator Templates Customizer V4.0 fixpak3 contains VisualAge Generator Templates Customizer new enhancements and bug fixes for the following: Enhancement of the Browsers o Data Element, Value Table editing. The tabbing between the cells works correctly o package and project names in the parameters editors are larger and fully visible o Relational Import: Temporary Tables (DB2/MVS) can now be imported Generated Web client (Java) o New Naming Policy of the items in the UI-Record The generated item names are more easy to read and take into account muliple displays in one single interface unit. o New Hooks Several new hooks are available in the web transaction to customize the initialization of the program, the server calls and the display. o Concurrency management (timestamp or counter) is available in XFer & Converse. o Error Handling is improved. o Value table management is improved. No duplicate of the current value. o Help List display is improved. The current item position in the list is preserved. o Column Labels are used in lists instead of default labels o Access Level is taken into account in the lists. The definition of the UI-Record is thus optimized (less fields) Generation Improvement (Java) o The Select Generator window in Java has been improved ------------------------------------------------------------------------ Limitations and Known Problems o Common Limitations + VAGT Workbench: + SQL low value and SQL high value (Workspace definition) are not exhaustively checked; these attributes should not be empty (space is a valid value). + Web Generators: + You may have to customize the code if you use more than one business object in one interface unit. Various hooks are available. + The updatable lists are not available. + GUI Generators: + The '4GL' Client Logic Style (Workspace Parameter) is not implemented. o Templates on Java Limitations + GUI Generators: + On VisualAge for Java, you need to check 'Inherit BeanInfo of Bean superclass' in the panel 'Options', under 'Visual Composition' to have your generated GUI work properly. + Relational Table: The 'read' concurrency management is not supported by the client. o Templates on Smalltalk Limitations + Installation: After the load of the VAGT feature, the VisualAge Organizer may have lost the current user. Ensure to set a current user before using the VAGT feature (otherwise the menu items of the VAGT Tools menu will stay disabled). + Generation: + If you use a workspace that was not defined with the QuickStart, it is better to unload MdlQSRuntimeApp. + Workspace: 'Target Services Application' and 'Target Visual Application' parameters are not taken into account. Only 'Target Logic Application' is used. + Bidi: Although VAGT is able to provide right-to-left organized views and subviews, it depends on the abilities of VisualAge Smalltalk BiDi feature for internal positionings: + menus inside a menu bar + columns inside a container + tabs inside a notebook + Database Management: When connecting to the database, you may have database connections left open (an error -1445 appears), you should clean up SQL database connections so you can execute the following code to clean up the SQL interface: SQLRequester disconnectAll Installation Preparing for Installation Hardware/Software Requirements VisualAge Generator Templates Customizer Version 4.0 fixpak 3 requires the following software and hardware: o To install VisualAge Generator Templates Customizer on Java : VisualAge Generator Developer 4.0 fixpak 3 on Java. o Software and hardware that are required by VisualAge Generator Developer V4.0 fixpak 3. Note: VisualAge Generator Templates Customizer 4.0 fixpak 3 will not install if VisualAge Generator Templates Customizer 4.0 has not been installed previously on the machine. ---------------------------------------------------------------------- Installing VisualAge Generator Templates Customizer on Java To download from FTP site: 1. Create a temporary directory on your hard drive. 2. Download the self-extracting executable MDL40V3N.EXE to a temporary directory on your hard drive. 3. Extract the files contained in the self-extracting EXE file to the same temporary directory To install VisualAge Generator Templates Customizer on Java: 1. Set the current directory to the temporary directory you created to store the FixPak files. 2. Run 'setup'. 3. When prompted, select VAGT Customizer on Java. 4. Once Customizer has been installed, reboot. 5. From the Start menu, select Programs, then select IBM VisualAge for Java for Windows, and then select IBM VisualAge for Java to bring up the product. 6. For Workspace owner, select Administrator, and then specify your network name. Installing the VisualAge Generator Templates Customizer feature: You should load the VAGT Customizer feature in a Java workspace that does not contain VAGT 'standard' feature. If you already have VAGT 'standard' feature loaded, then you should unload the feature or install an empty image. You can find an original ide.icx in the VisualAge For Java CD, in ivj30\backup directory. 1. On the Workbench, select File>>Quick Start. 2. On the Quick Start dialog, select Features on the left. Add Feature on the right, and then select OK. 3. Select IBM VisualAge Generator Templates Customizer 4.0 + FP3, and select OK (this will take a few minutes). 4. Close the Workbench, and, then, close the Log. You will be prompted to save the workspace. Select OK to save the workspace. ------------------------------------------------------------ Installing VisualAge Generator Templates Customizer on Smalltalk To download from FTP site: o Create a temporary directory on your hard drive. o Download the following self-extracting executable to a temporary directory on your hard drive: 1. for OS/2: MDL40V32.EXE 2. for Windows/NT: MDL40V3N.EXE The address of the FTP site is ftp://ps.software.ibm.com. This site contains information and fixes for a wide variety of other IBM products. The files for this FixPak are located in the directory /ps/products/visualagetemplates/fixes/v4.0. You may perform an anonymous logon to this FTP site. o Extract the files contained in the self-extracting EXE file to the same temporary directory. To install VisualAge Generator Templates Customizer on Smalltalk: o Set the current directory to the temporary directory you created to store the FixPak files. o Run 'setup' (for Windows/NT) or 'install' (for OS/2). o When prompted, select VAGT Customizer on Smalltalk. o Once Customizer has been installed, reboot. To load the VisualAge Generator Templates Customizer features after installing VisualAge Generator Developer on Smalltalk: o Before starting the workspace, you should consider saving a copy of the VisualAge for Smalltalk image named abt.icx. o Start VisualAge for Smalltalk. o Select Tools>>Load/Unload Features... on the System Transcript. o In the Selection Required window: 1. Make sure that "Show other features" is checked. 2. Select Other: VAGTemplates Customizer 40 - fixpak 3 from the Available features list. 3. Click on the OK button. VisualAge Generator Templates Customizer will be imported and loaded into your workspace. The load function will also ensure loading of the prerequisites, VisualAge ODBC Database and DB2 CLI Database. This could take up to half an hour to finish. 4. Once VisualAge Generator Templates Customizer is loaded, you will be prompted to save your image. Click the Yes button so you won't have to load VisualAge Generator Templates Customizer the next time you start VisualAge for Smalltalk. By default, the image is saved as filename abt.icx. After the image is saved, you might consider making a copy of the image file. Note:If you get a walkback (VisualAge Debugger) window while saving the image, it probably means that you have run out of disk space. If this happens, close the VisualAge Debugger window and either free some space on your workstation and retry saving in the same place or save the image on another drive by selecting File>>Save Image As....