IBM VisualAge Generator V4.0 FixPak1 Readme

IBM VisualAge Generator
V4.0 FixPak1 Readme
PTF #: UQ41558

Introduction

FixPak1

Product Enhancements, Support, & Limitations

Windows 2000 Compatibility
VisualAge Generator feature unloadable from workspace on Java
Quick form support in Java GUI
WebSphere 2.0 for NT support
Migration
Performance improvement during Import/Migration
Full Import/Export support regardless of parts sources
Java Execute Batch Command
Parts Browser Menu Item APIs
Launching online help from Start Menu
Japanese online help search capability
List of APARs

GUI
Developer
Interactive Test Facility
CSO
C++ Workgroup Services
C++ Generation
COBOL Generation
IC Packaging

Other fixes
Limitations

VisualAge Generator v4.0 FixPak1 Installation Notes

Installing VisualAge Generator Developer on Java
Installing VisualAge Generator Developer on Smalltalk
Installing VisualAge Generator Server
Installing VisualAge Generator Common Services

VisualAge Generator Templates

Product Enhancements

Import/Export Function
Relational Import
VAGT Workbench
Generated Web Client
Generated GUI Client
Generated TUI
Generation

Generator Templates Standard Functions Installation
Limitations and Known Problems

Installation Troubleshooting
VisualAge Generator Redbook

Online Documentation

Introduction

This VisualAge Generator V4.0 FixPak1 Readme file contains the latest installation instructions, product support, and limitation information. You can also view the .HTM version of this Readme file using a web-browsing program.

FixPak1

Product Enhancements, Problem Support, and Limitations

VisualAge Generator V4.0 FixPak1 contains enhancements, problem support, and limitations for the following:

· Windows 2000 Compatibility

With this Fixpak, VAGen Developer on Java, VAGen Developer on Smalltalk and VAGen Server are Windows 2000 Ready.
VisualAge Generator v4.0 Fixpak 1 provides full compatiblility to Windows 2000. However, since generated code for Windows 2000 and Windows NT are essentially identical, there won't be a seperate generation platform option for Windows 2000 both in VA Java-based Developer and VA Smalltalk-based Developer.
If you wish to use EMSRV on Windows 2000 in VA Java, you must download the manager fixpak from the VisualAge for Smalltalk download site: http://www-4.ibm.com/software/ad/smalltalk/downloads/.

· VisualAge Generator feature unloadable from workspace on Java

Code has been added in FixPak 1 of VAGen 4.0 to support deleting the VAGen 4.0 feature from the workspace. This will be useful when installing subsequent VAGen FixPaks and FixTests. Follow these steps to remove the VAGen feature:

From the Quick Start menu, choose Delete Feature.
Select IBM VisualAge Generator 4.0 + FP1 and IBM VisualAge Generator Utilities 4.0 + FP1.
Select OK.
Save the workspace and exit VisualAge.
At this point you can install a newer version of VAGen.
Start IBM VisualAge for Java.
Add the feature IBM VisualAge Generator 4.0 + xxx (where 4.0 + xxxx is the installed version).
Save the workspace and exit VisualAge.
Start IBM VisualAge for Java.

· Quick Form Support in Java GUI

Quick form support for VAGen data parts.

The quick form support has been added to give the ability to quick form VAGen data parts and their data items.

When choosing the "Quick form..." option from the context menu of a data part or a non-array item tearoff, the SmartGuide dialog for Quick Form is displayed with the "Create a new quick form" option selected as the default. The properties list shows only the properties that make sense to quick form. As the default, all properties shown are selected except "data" property. For the properties that are simple array items, the Swing List (JList) is selected as the registered quick form, but the Swing Combo Box (JComboBox) can also be selected.
When choosing the "Quick form..." option from the context menu of a simple array item tearoff, the SmartGuide dialog for Quick Form is displayed with the "Use an existing registered quick form" option selected as the default. The registered quick form selected is the Swing List (JList). This default allows you to create a Swing List to display the array item. You can also choose to select the Swing Combo Box (JComboBox) instead.
When choosing the "Quick form..." option from the context menu of a compound array item tearoff, the SmartGuide dialog for Quick Form is displayed with the "Use an existing registered quick form" option selected as the default. The registered quick form selected is the Swing Table (JTable). This default allows you to create a Swing Table to display the compound array item. If you do not want to display the compound array item in a Swing Table but want to display some or all of the sub items as lists, you can select the "Create a new quick form" option then work with the properties shown in the list.

The "Save Quick Form" option is not available for VAGen data parts and their item tearoffs, and therefore, the "Save Quick Form" page is not available on the SmartGuide dialog.

· WebSphere 2.0 for NT Support

By default the VisualAge Generator GatewayServlet supports java application servers that support JSP specification 1.0 and Servlet 2.1 support. Websphere 2.0 and other application servers that support JSP 0.92 and Servlet 2.0 are now supported as well. In order for the GatewayServlet to run with Servlet 2.0 support, the hptServletVersion parameter must be set to 2.0 in the VisualAge Generator GatewayServlet properties file.
There are no changes required for the generated UI bean to be used with Websphere 2.0.
In order to use the generated JSPs with an application server that only supports the JSP specification 0.92, the generated JSPs must be modified. The following changes must be made to the JSP.

<%@ page import = "com.ibm.vgj.uibean.VGDataElement" %>
becomes
<%@ import="com.ibm.vgj.uibean.VGDataElement" %>
<jsp:useBean id="JANEUI1" scope="request" class="MY.PKG.JANEUI1Bean" />
becomes
<BEAN NAME="JANEUI1" SCOPE=REQUEST TYPE="my.pkg.JANEUI1Bean"></BEAN>

VAGenerator provides a conversion utility in the hptgateway.jar file included with Fixpak1. The command syntax to perform the conversion is as follows:

java ConvertJSP1toJSP92 filename

where filename is the .jsp file to be converted. The converted file will replace the existing file.

· Migration

PLP Migration on Java from v3.0 to v4.0.

In GA version, there is no automatic creation during Migration of the PLP. A user could only code it manually. It now can be automatically generated during migration. The PLP is used in Generation and when a Project is added to the Workspace (this is optional based on a check box). PLP is analagous to Required Maps in Smalltalk.

MSL Migration on Java from v3.0 to v4.0.

In MSL Migration, the sandbox is the "VG Part Prerequisites View". In Generator on Java, the Sandbox is where the parts and the packages they belong to are kept before storing them into the Repository. Before this Fixpak, when user exits VAGen parts browser during MSL migration, the loaded VAGen parts information is lost and would have to be laboriously reconstructed. In Fixpak 1, the "Save Sandbox" feature stores the VG Parts information in the Java Workspace. Upon reentry into "MSL Migration Part list", the Sandbox is automatically reconstructed for further accumulation of VG Parts in the Sandbox. If the user desires to exit Java again, they will need to do another "Save Sandbox".
There is a minor problem with the regular (non migration) icx where the "Tools" menu item on the Parts Browser shows a "Migration" menu option. When the "Migration" option is selected, the "Msl Migration" menu option is enabled. This should not be there! Do not select it as this will result in a "walkback".

· Performance improvement during Import/Migration

Fixpak1 includes APAR PQ35519 which should be applied before migrating processes and statement groups to Version 4.0. Without this fix, many blank lines are added to the end of the 4GL logic whenever the logic ends with a comment line without a statement on the last line. This causes extreme performance implications during import (without the fix import takes 18+ hours; with the fix the same import takes only 8 minutes!!) and creates parts in ENVY that are significantly larger than necessary. How much larger than necessary depends upon where the part is located in the ESF file. This fix applies to import. However, since import is used during migration, the same impact will be seen during migration of parts from any earlier version of the product. If you have migrated parts from earlier versions and have not modified them since migration, you might wish to consider remigrating. The reason is that these extra blank lines will affect the performance of all components of the product.

· Full Import/Export support regardless of parts sources

With the GA version of the product, it was not recommended that customers export and import parts that were produced by VisualAge Generator Templates. This was due to errors in the ESF export and import processing. With the delivery of FixPak 1, this restriction has been removed. Export and import of all types of parts, regardless of their source is completely supported.

· Java Execute Batch Command

With this Fixpak, support for the Execute batch command has been added for Java. The execute command allows you to invoke Java methods within the IDE from an operating system command prompt. For details on this feature, see the VAGen User's Guide, available on the VisualAge Generator website at http://www.ibm.com/software/ad/visgen/library/v4docs.html.

· Parts Browser Menu Item APIs

In this FixPak, Smalltalk and Java APIs have been added which allow menu items to be added to the VAGen Parts Browser menus. For details on this feature, see the VAGen User's Guide, available on the VisualAge Generator website at http://www.ibm.com/software/ad/visgen/library/.

· Launching online help from Start Menu

This fixpack contains numerous updates of the online help and HTML books.
For this fixpack, an icon that enables you to start the online help without starting VisualAge Generator has been added to the Start menu for Windows and the VisualAge Generator product folder for OS/2.

· Japanese Online Help search capability

The search capability for Japanese online help has been enabled for Windows NT-based Developer.

· List of APARs

The following is a list of APARs in FixPak1:

GUI:

PQ33872

FEATURES ARE NOT CURRENTLY BEING SORTED ALPHABETICALLY IN THE SCRIPT WIZARD.

PQ34037

ISO DATE FORMAT NOT DISPLAYED ON A GUI.

Developer:

PQ28946

PROCESS TERMINATION DURING A RUNTIME OBDC CONNECTION TO SQL SERVER 6.5 WOULD OCCUR DURING A FCWTRACE.

PQ32524

VISUALAGE GENERATOR DEVELOPER WHEN COMPARING ITEMS IN AN SQL ROW RECORD WITH THE COLUMNS IN THE SQL TABLE.

PQ33873

MMENOMICS PROBLEMS WITH JAPANESE DEVELOPER PRODUCT.

PQ34405

Sample program , Employe, provided with VisualAge Generator 4.0 will not validate.

PQ34444

VALIDATING AN SQL STATEMENT TERMINATING IN TWO RIGHT PARENTHESIS WOULD FAIL IF A SPACE WAS NOT PLACED BETWEEN THESE LAST TWO PARENTHESIS.

PQ34445

RESOLVES PROBLEM AFTER FP4 IN VISUALAGE GENERATOR V3 ON WINDOWS NT. AN ERROR MESSAGE WOULD BE PRODUCED WHEN USER ATTEMPTED TO MODIFY AN "ORDER BY" CLAUSE, CHANGE THE OPTION TO "SINGLE ROW SELECT" AND SUBSEQUENTLY ATTEMPTS TO SAVE IT.

PQ35519

Performance and part size improvement during import and/or migration.

Interactive Test Facility:

PQ30790

WEB SERVER WOULD FAIL WHEN CALLING A SERVER PROGRAM USING A JAVA WRAPPER FROM A JAVA SERVLET.

PQ34320

ITF PARTITIONING LINES BETWEEN PROGRAMS PASSING PARAMETERS IMMEDIATELY RED.

PQ34443

IN ITF, A CALL TO EZECONCT FAILED WITH MESSAGE SQL1013N DUE TO A MISINTERPRETATION OF RESET AS A DATABASE NAME.

CSO:

PQ307903

WEB SERVER CRASHESWHEN CALLING A SERVER PROGRAM USING A JAVA WRAPPER FROM A SERVLET ON AIX.

PQ35923

Using Java wrappers to call a server program from a session bean, get invalid message CSO7831E CLIENTBUFFER TOO SMALL WHEN USING VISUALAGE GENERATOR, when the enterprise Java server is running on an AIX platform.

C++ Workgroup Services:

PQ23397

IF AN CALLED APPLICATION IS INVOKED MULTIPLE TIMES AND ERROR MESSAGE WAS SOMETIMES RETURNS RESULTING FROM EXCEEDING THE NUMBER OF FILE HANDLES AVAILABLE.

PQ26367

FIXED AN ISSUE WHERE PRINTER OUTPUT FROM CICS TRANSACTIONS TO A CICS CLIENT ATTACHED PRINTER.

PQ27525

ADDED A CARRIAGE RETURN TO PRINTER OUTPUT ON AIX.

PQ29144

AIX AND HP VISUALAGE GENERATOR PROGRAMS THAT ACCESSED AND UPDATED OR DELETED ALL ROWS OF A TABLE MAY FAIL DUE TO A WARNING MESSAGE FROM DB2.

PQ30861

VISUALAGE GENERATOR V3.1 APPLICATIONS FOR MICROSOFT VISUAL C++ V5 AND V6 WOULD GENERATE A COMPILE LINK ERROR WHEN PREPARING AN APPLICATION THAT CONTAINED:
"IF DATA_ITEM1 IN DATA_ITEM2[INDEX1]"
WHERE DATA_ITEM1 IS A BIN (LENGTH 2), DATA_ITEM2 IS A BIN, AND INDEX IS NUM

PQ31179

RESOLVED AN ERROR ACCESSING REMOTE ESDS VSAM FILES FROM VISUALAGE GENERATOR WITH ITF OR GENERATED C++ APPLICATIONS.

PQ18083

REPLACE OPTION'S MALFUNCTION ON RESOURCE ASSOCAIATION FILE.

PQ28546

SBCS BLANK OR DBCS BLANK(AFTER APPLYING PQ23794)IS INSERTED TO.

PQ33008

MEMORY LEAK IN VISUALAGE GENERATOR SERVER WHEN RUNNING PROGRAM.

PQ33190

EXEC CICS SYNCPOINT INCORRECTLY ISSUED IN VG PROGRAM CALLED FRO.

PQ33447

INCORRECT RESULT FROM ARITHMETIC OP IN CICS/AIX.

PQ33902

VA GEN V4.0 FCWCICSINSTALL.BAT REFERS TO V3.1 SUBDIRECTORIES.

PQ34441

EZECONCT RESET FAILED WITH SQL -1001.

C++ Generation:

PQ33261

LITERAL VALUE FOR UOW ON EZECONCT STATEMENT CAUSES COMPILE ERROR.

PQ27998

VG didn't create correct C++ code if "Oracle" was used on the /DBMS option.

PQ34047

/REPLACE option malfunctions on resource association file.

PQ33446

Preparation error if local item is used as a host variable.

COBOL Generation:

PQ22063

FIXED PREPROCESSOR ERROR DUE TO MISSING BEGIN AND END DECLARATIONS IN SOURCE GENERATED FOR COBOL ENVIRONMENTS USING ANSISQL.

PQ22590

RESOLVED THE FOLLOWING COMPILER ERROR FOR GENERATING TO COBOL TARGET ENVIRONMENTS:
IGYPS2121-S "ezemsf-function-id" WAS NOT DEFINED AS A DATA NAME
IGYPS2121-S "ezemsr-request-block" WAS NOT DEFINED AS A DATE.

PQ25670

VISUALAGE GENERATOR USERS TARGETING VSE BATCH AND ARE USING THE FEATURE THAT ALLOWS BLOCK SIZES TO BE SPECIFIED FOR SERIAL FILES OF TYPE SEQ WOULD FAIL TO COMPILE.

PQ25672

ADDED SUPPORT FOR NO LABEL TAPES FOR VSE BATCH TARGETED APPLICATIONS.

PQ27960

GENERATING COBOL WOULD RETURN AN UNEXPECTED ERROR WHEN USING EZETST AS AN INDEX IN A MOVEA STATEMENT.

PQ29398

INCORRECT BEHAVIOR RESULTED IN A BLANK FIELD BEING DISPLAYED WHEN MOVING A ZERO TO THAT FIELD IN COBOL GENERATED PROGRAMS.

PQ30339

VISUALAGE GENERATOR V3.1 AND V4.0 PROGRAMS WOULD FAIL TO COMPILE WHEN THE STATEMENT TRACE IS ISSUED AND THE REFERENCE MODIFIERS ON A MOVE TO TRACE-STRING WILL BE GREATER THAN THE TOTAL LENGTH OF THE TRACE-STRING.

PQ30987

VISUALAGE GENERATOR V3.1 AND V4.0 APPLICATIONS USING AN EZELPCB ARRAY WITH MORE THAN 9 ELEMENTS WOULD BE TRUNCATED TO ONE DIGIT SUBSCRIPT CAUSING INCORRECT EXECUTION BEHAVIOR.

PQ31338

THE '¬=' OPERAND WAS USED RATHER THAN THE 'NE' OPERAND FOR SSA IN VISUALAGE GENERATOR GENERATED COBOL.

PQ33815

When generating an application that has a record that only contains Level-77 items, a SET RECORD EMPTY statement will reference a non-existing record.

PQ32620

When using a SQL record with a hex or dbcs field in it, incorrect COBOL is generated causing a COBOL compilation error.

PQ34767

When transferring from one main function to another via the flow, after the second main function has completed , control returns to the flow of the first main function instead of the second. The control returns to the next command after the one that sent control to the second main function.

PQ35352

VA GEN WEB TRANSACTION FAILS ON MVS/CICS WHEN TRANSFERRING CONTROL VIA THE XFER STATEMENT.

IC Packaging:

PQ34412

WALKBACK ISSUED WHEN RUNNING WITH VISUALAGE GENERATOR IC'S.

· Other fixes

Java GUI

Problems in generated client code: Client code generated has compiled errors when you tear off a property of a VAGen variable first and then add another VAGen part after that.
Tearoff from VAGen Variable does not show correct properties: Tear off a property from a VAGen Variable that has VAGen type set to a VAGen Record. The tearoff does not show any features that belong to that data item (for example, the array methods are not shown for the array tearoff).
Removing value from a Text Field that is connected to a VAGen numeric data item causes an exception: When removing the current value from a Text Field that is connected to a numeric VAGen data item, the generated connection code tries to parse an empty string for a long and that produces an exception that is shown in the Console. The fix generates code that does not parse an empty string but sends 0 to the data item.

Smalltalk GUI

Quick form of #self of a VAGen Record is in random order: The order of fields created from a quick form of a VAGen Record's #self attribute is random instead of the order of the data items in the record.
Walkback debugging a connection involving a VAGen Variable.
Walkback copying to the clipboard from the free form surface.

· Product Limitations

Generating remote Java (UI Records) and C++ applications on Windows 2000 will result in the Generate UI not completing and no prep/compile performed on the target machine. The last message seen on the Geneation Monitor is "submitting prepare". The problem is an error in the generated ftp file. To bypass the error:

Edit the xxx.ftp file (where xxx is the application name) and add quit to the last line.
Execute command:

xxx.cmd * * userid password

(where xxx is the application name, userid and password are those used by the targeted system).

If you have multiple applications to generate, after editing the xxx.ftp files create a batch file which lists the xxx.cmd's to be executed and execute the batch file.

There is a minor problem with the regular (non-migration) icx where the "Tools" menu item on the Parts Browser shows a "Migration" menu option. When the "Migration" option is selected, the "Msl Migration" menu option is enabled. This should not be there! Do not select it as this will result in a "walkback".
Problem: Transfer to remote OS/400, MVS, VSE or VM system from Windows NT failed without any messages available in the view messages screen and prpout.log file is not available.

If you are experiencing this particular transfer problem when generating to these remote systems, please check first that you have the correct version of ObjRexx installed. This is ObjREXX 1.0.3.0 - interpreter version. The CD for this product should be included as part of VisualAge Generator 4.0 package. To check the version of rexx on your system, type: rexx /ver at a command prompt. If rexx is having a problem understanding this command, this would be an older version.

The most probable cause of this particular problem is that the file or directory that you have specified either as a genout directory and/or the "Start in" directory value contains a space in the directory name.
A quick work around for this is:

Before starting VisualAge Generator:

If you start VisualAge Generator from an icon on desktop:
Do:

a. Right mouse click icon -->Properties
b. When properties window comes up, click on Shortcut tab.
c. Check that directory value specified in "Start in:" field does not point to a directory with a space in the directory path. - if so, change the value in the field to an existing directory that does not contain a space in the directory path.
d. Apply, and close.
f. Start VisualAge Generator from Icon.

If you start VisualAge Generator from the Start menu:
Do:

a. Click on Start Menu--> Find --> Files or Folders
b. Fill in the field as such: Named: VisualAge Generator Look in: C:\WINNT40\Profiles
c. Find the shortcut that maps to the actual VisualAge Generator executable.
d. Right mouse click on the shortcut --> Properties
e. When properties window comes up, click on Shortcut tab.
f. Check that directory value specified in "Start in:" field does not point to a directory with a space in the directory path. - if so, change the value in the field to an existing directory that does not contain a space in the directory path.
g. Apply, and close.
f. Start VisualAge Generator from Start Menu.

If you start VisualAge Generator from a command prompt, from an directory that doesn't contain space, do: "start ide".

On generation:
When specifying the generation output directory at generation time, do not use space in directory and/or file name.

The online documentation has the following restrictions:

For OS/2, Japanese, VAGen help search is not enabled.
For Japanese help, some HTML browsers initially display characters incorrectly. Maximize the browser to correct the problem.
For Japanese and Portuguese, introductory pages are in English.
For Japanese and Portuguese, translated books and glossaries are not currently available.
If you are having problems with Brazilian Portuguese help search on OS/2, run the following commands. You'll need to locate your NetQuestion directory. It should be called either NETQOS2 or IMNNQOS2. Then locate the directory where you have installed VisualAge Generator.
In a command window, navigate to the the NetQuestion directory and type:

1. hptcfg remove /p hptsphlp

2. hptcfg install /multiple /lang pt_br /w x:\<Smalltalkdirectory>\doc\vghelpp

3. imnss stop server

4. imnss start server

If you are having problems with Japanese help search on OS/2, run the following commands. You'll need to locate your NetQuestion directory. It should be called either NETQOS2 or IMNNQOS2. Then locate the directory where you have installed VisualAge Generator.
In a command window, navigate to the the NetQuestion directory and type:

0. hptcfg remove /p hptsjhlp

1. hptcfg install /multiple /lang ja_JP /w x:\<Smalltalkdirectory>\doc\vghelpj

2. imnss stop server

3. imqss -stop dbcshelp

4. imqss -start dbcshelp

5. imnss start server

Note: These same commands will work on NT. The only difference is that you run them from the NT NetQuestion directory, typically called IMNNQ_NT.

VisualAge Generator FixPak1 Installation Notes

Important: The following sections provide detailed instructions for downloading and installing FixPak1 for VisualAge Generator V4.0. Please be sure to read the sections carefully before you install this FixPak.

Installing VisualAge Generator Developer on VA Java

Important: Special steps to do before installation of Fixpak 1 for Developer on Java:

If users have an existing repository and want to continue using it, VisualAge for Java provides a migration feature to migrate the repository to VisualAge for Java v3.02. Please refer to the VisualAge for Java Team Repository Server CD readme file for detailed instructions.

Note: To apply VAGen v4.0 Fixpak 1, the user should first install VAGen v4.0 Fixpak 1, and then install VisualAge for Java v3.02. (That is true, you install VAGen v4.0 Fixpak 1 before installing VisualAge for Java v3.02). There's no need to uninstall VisaulAge for Java v3.0.

You may obtain FixPak1 of VisualAge Generator in two ways: (1) download the code from the IBM software support FTP site; or (2) obtain the code in the form of a CD. In order to reduce the download size there are language-dependent .exe installation files, if you know the language of your base product, you may just download the smaller language-dependent file instead of the full installation file.
To install VAGen v4.0 Fixpak 1, download and run VGDVJFP1.EXE or the language-dependent DVJXXXF1.exe (XXX stands for the NLS abbreviation: ENU-English, JPN-Japanese, PTB-Brazilian Portuguese) from the FTP site, or run SETUP.EXE from the \Windows\Java directory on the FixPak1 CD. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
FixPak1 for Common Services V4.0 is a prerequisite for running Developer with FixPak1. If you have not installed FixPak1 for Common Services yet, you will be prompted to install it. For Windows NT, the files for installing FixPak1 for Common Services are already included in the package, so you do not have to download it separately if you are using Windows NT.
After VisualAge Generator v4.0 Fixpak 1 is installed, install VisualAge for Java 3.02. (Note: Due to the size of VisualAge for Java v3.02, we did not incorporate the VisualAge for Java in our product's installation image. But you may go to VisualAge Developer Domain to download. The installation images for VisualAge for Java will be broken into four parts to reduce download size, the Base Product, the Debugger, the Connector and the extras. For more information, go to http://www7.software.ibm.com/vad.nsf/Data/Document3793.) The installation CDs will be available to order from VisualAge Developer Domain on April 4th.
You do not have to manually add the VisualAge Generator V4.0 FixPak1 feature, unless you do not have the VisualAge Generator V4.0 (release version) feature already loaded in VisualAge for Java 3.0.
Sometimes after the installation of VisualAge for Java v3.02, if you bring up the IDE, an error message appears saying: Exit due to error: 34 - Read error occured while loading workspace. If you see this, your workspace IDE.icx is corrupted (you may verify this by checking if the IDE.icx's file size goes down to 0). To work around this, find the IDE.ZIP file on the installation CD in directory ivj30\backup, unzip the IDE.ICX file to IDE\program directory under the VisualAge 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.

Installing VisualAge Generator Developer on VA Smalltalk

For Windows NT

You may obtain FixPak1 of VisualAge Generator in two ways: (1) download the code from the IBM software support FTP site; or (2) obtain the code in the form of a CD. In order to reduce the download size there are language-dependent .exe installation files, if you know the language of your base product, you may just download the smaller language-dependent file instead of the full installation file.
Download and run VGDVSFP1.EXE or the language-dependent DVSXXXF1.exe (XXX stands for the NLS abbreviation: ENU-English, JPN-Japanese, PTB-Brazilian Portuguese) from the FTP site, or run SETUP.EXE from the \Windows\Smalltalk directory on the FixPak1 CD. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
Our installation will automatically install the Client Fixpak, Manager Fixpak of VisualAge for Smalltalk v5.01. For more information, visit the VisualAge for Smalltalk download site: http://www-4.ibm.com/software/ad/smalltalk/downloads/.
FixPak1 for Common Services V4.0 is a prerequisite for running Developer with FixPak 1. If you have not installed FixPak1 for Common Services yet, you will be prompted to install it. The code for FixPak1 for Common Services is already included in the package, so you do not have to download it separately.
After you install Fixpak1 for VisualAge Generator Developer on Smalltalk V4.0, it becomes an available, loadable feature of VisualAge for Smalltalk. To complete the installation of VisualAge Generator V4.0 Fixpak1, perform the following customization tasks:

Start VisualAge for Smalltalk.
Select Tools --> Load/Unload Features... on the System Transcript window.
On the Selection Required window, do the following:
Ensure that the Show other features check box is checked.
Select Other: VAGen Developer - Fixpak1 from the Available features list. If you want to update other features included in the fixpak, please select them as well.
Click on the >> button to move Other: VAGen Developer - Fixpak1 to the Loaded features list. If you selected other features, they will be moved as well.
Click on the OK button. The selected features will be imported and loaded into your image.
Once the selected features are loaded, you will be prompted to save your image. Press the Yes button. After the image is saved, you might want to make a copy of the image file just in case you need it later.

If you get a walkback (VisualAge Debugger) window while saving the image, it probably means that you have run out of disk space. Close the VisualAge Debugger window. You will need to either free some space and retry the save (File --> Save Image... on the System Transcript window) or save the image on another drive (File --> Save Image As...).

If you wish to use the IC Packaging feature, select the feature Other: Hpt IC Hot Fix V4.0 FP1.1 and load it. Make sure that this is done after the FixPak1 feature is loaded. (If you can not find the feature, you can download it (a self-extracting file ICotFix.exe) from the VisualAge Generator FTP site /ps/products/visualagegen/info/v4.0/hotfix3, and install the files (follow the install directions from the readme file for that HotFix), close the VisualAge Generator on Smalltalk, open it again, and then you should be able to load the feature Other: Hpt IC Hot Fix V4.0 FP1.1.)

For OS/2

To download from FTP site:

Create a temporary directory on your hard drive.
Download the self-extracting executable DV2FP1B.EXE to a directory named BASE relative to the temporary directory on your hard drive. This file is located in the BASE directory on the FTP site. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
Download the self-extracting executable DV2FP1x.EXE to a directory named XXX relative to the temporary directory, where XXX stands for the 3-character NLS ID corresponding to your language. The letter "x" stands for the 1-character NLS ID corresponding to your language. On the FTP site, this file is located in the directory named by the 3-character NLS ID corresponding to your langauge. (For example, if you are using English, you will download DV2FP1E.EXE, located in the ENU directory).
Extract the files contained in the two self-extracting EXE files to the same temporary directory by invoking them with the -d switch from the command prompt.
For example: Type in DV2FP1E.EXE -d on the command line.

To install:

If you downloaded FixPak1 from the FTP site, run INSTALL.EXE from the directory <temp>\xxx\HPTDEVS2, where <temp> is the temporary directory you created to store FixPak1 files, and "xxx" is the 3-character NLS ID for your language.
For example: If your language is Japanese and the temporary directory you selected is called FIXDEV, you would enter the following command on the command line: FIXDEV\JPN\HPTDEVS2\INSTALL.EXE
If you have the CD for FixPak1, run the command <CD-ROM drive letter>\xxx\HPTDEVS2\install, where "xxx" is the 3-character NLS ID for your language.

Our installation will automatically install the Client Fixpak, Manager Fixpak of VisualAge for Smalltalk v5.01. For more information, visit the VisualAge for Smalltalk download site: http://www-4.ibm.com/software/ad/smalltalk/downloads/.
FixPak1 for Common Services V4.0 is a prerequisite for running Developer FixPak 1. Download and install FixPak 1 for Common Services V4.0. Installation instructions for FixPak1 for CSO are contained below.
After all the installation is completed, you may remove the temporary directory holding the installation files.
After you install Fixpak1 for VisualAge Generator Developer on Smalltalk V4.0, it becomes an available, loadable feature of VisualAge for Smalltalk. To complete the installation of VisualAge Generator V4.0 Fixpak1, perform the following customization tasks:

Start VisualAge for Smalltalk.
Select Tools --> Load/Unload Features... on the System Transcript window.
On the Selection Required window, do the following:
Ensure that the Show other features check box is checked.
Select Other: VAGen Developer - Fixpak1 from the Available features list. If you want to update other features included in the fixpak, please select them as well.
Click on the >> button to move Other: VAGen Developer - Fixpak1 to the Loaded features list. If you selected other features, they will be moved as well.
Click on the OK button. The selected features will be imported and loaded into your image.
Once the selected features are loaded, you will be prompted to save your image. Press the Yes button. After the image is saved, you might want to make a copy of the image file just in case you need it later.

If you wish to use the IC Packaging feature, you must also select the feature Other: Hpt IC Hot Fix V4.0 FP1.1 and load it as well. Make sure that this is done after the FixPak1 feature is loaded.

Installing VisualAge Generator Server

For Windows NT

Download and run VGWGSFP1.EXE from the FTP site, or run SETUP.EXE from the \Windows\Server directory on the FixPak1 CD. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
FixPak1 for Common Services V4.0 is a prerequisite for running Developer with FixPak 1. If you have not installed FixPak1 for Common Services yet, you will be prompted to install it. The files for FixPak1 for Common Services are already included in the package, so you do not have to download it separately.

For OS/2 Warp

To download from FTP site:

Create a temporary directory on your hard drive.
Download the self-extracting executable SR2FP1B.EXE to a directory named BASE relative to the temporary directory on your hard drive. This file is located in the BASE directory on the FTP site. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
Download the self-extracting executable SR2FP1x.EXE to a directory named XXX relative to the temporary directory, where XXX stands for the 3-character NLS ID corresponding to your language. The letter "x" stands for the 1-character NLS ID corresponding to your language. On the FTP site, this file is located in the directory named by the 3-character NLS ID corresponding to your langauge. (For example, if you are using Brazilian Portuguese, you will download SR2FP1P.EXE, located in the PTB directory).
Extract the files contained in the two self-extracting EXE files to the same temporary directory by invoking them with the -d switch from the command prompt.
For example: Type in SR2FP1P.EXE -d on the command line.

To install:

If you downloaded FixPak1 from the FTP site, run INSTALL.EXE from the directory <temp>\xxx\HPTWGS2, where <temp> is the temporary directory you created to store FixPak1 files, and "xxx" is the 3-character NLS ID for your language.
For example: If you are using Brazilian Portuguese and the temporary directory you selected is called FIXWGS, you would enter the following command in the command line: FIXWGS\PTB\HPTWGS2\INSTALL.EXE
If you have the CD for FixPak1, run the command <CD-ROM drive letter>\xxx\HPTWGS2, where "xxx" is the 3-character NLS ID for your language.

FixPak1 for Common Services V4.0 is a prerequisite for running Developer with FixPak 1. Download and install FixPak 1 for Common Services V4.0. Installation instructions for FixPak3 for CSO are contained below.
After all the installation is completed, you may remove the temporary directory holding the installation files.

For AIX

For installation instructions for VisualAge Generator Server on AIX please see the "VisualAge Generator Installation Guide."

For HP-UX

1. On your HP-UX machine, create a temporary fixpak directory called FIXHP. (i.e. /home/user1/fixhp)

2. Download tar file VGWGS40X.TAR from the HP directory. The image environment is shown below:

VGWGS40X.TAR - HP-UX version 10.20

3. Login as root.

4. Change your current working directory to /opt.

5. type: tar -xvf /home/user1/fixhp/vgwgs40x.tar

6. If VisualAge Generator Server for HP_UX was previously installed on the machine it must be rejected before you can install a new version. To reject it, type:

rm -rf /opt/vgwgs40

Installing VisualAge Generator Common Services

FixPak1 for Common Service is a prerequisite for running the other VisualAge Generator products with Fixpak 1. The FixPaks of the other VisualAge Generator products contain the files to install FixPak1 for Common Services. Therefore, you do not have to download the FixPak for Common Services separately if you have already downloaded the FixPak for any other VisualAge Generator product.

On Windows NT, you will be prompted to install FixPak1 for Common Services at the end of the installation of any other FixPak for VisualAge Generator when the Common Services Fixpak1 hasn't been installed, and the installation of FixPak1 for Common Services will launch automatically.

On OS/2, you will have to follow the steps below to install the FixPak for Common Services.

For Windows NT

Download and run VGCSOFP1.EXE from the FTP site, or run SETUP.EXE from the \Windows\CSO directory on the FixPak1 CD. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
If you get a installation error -115 during the installation, please reboot the machine and try the installation again. This condition occurs in isolated cases where there are stray processes running in the system.

For OS/2 Warp

To download from FTP site:

Create a temporary directory on your hard drive.
Download the self-extracting executable CS2FP1B.EXE to a directory named BASE relative to the temporary directory on your hard drive. This file is located in the BASE directory on the FTP site. 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 FixPak1 are located in the directory /ps/products/visualagegen/fixes/v4.0. You may perform an anonymous logon to this FTP site.
Download the self-extracting executable CS2FP1x.EXE to a directory named XXX relative to the temporary directory, where XXX stands for the 3-character NLS ID corresponding to your language. The letter "x" stands for the 1-character NLS ID corresponding to your language. On the FTP site, this file is located in the directory named by the 3-character NLS ID corresponding to your langauge. (For example, if you are using Korean, you will download CS2FP1K.EXE, located in the KOR directory).
Extract the files contained in the two self-extracting EXE files to the same temporary directory by invoking them with the -d switch from the command prompt.
For example: Type in CS2FP1K.EXE -d on the command line.

To install:

If you downloaded FixPak1 from the FTP site, run INSTALL.EXE from the directory <temp>\xxx\HPTCSO2, where <temp> is the temporary directory you created to store FixPak1 files, and "xxx" is the 3-character NLS ID for your language.
For example: If you are using Korean and the temporary directory you selected is called FIXWGS, you would enter the following command in the command line: FIXWGS\KOR\HPTCSO2\INSTALL.EXE
If you have the CD for FixPak1, run the command <CD-ROM drive letter>\xxx\HPTCSO2, where "xxx" is the 3-character NLS ID for your language.

If you get a installation error -115 during the installation, please reboot the machine and try the installation again. This condition occurs in isolated cases where there are stray processes running in the system.
After all the installation is completed, you may remove the temporary directory holding the installation files.

VisualAge Generator Templates

Product Enhancements, Problem Support, and Limitations

VisualAge Generator V4.0 fixpak1 contain VisualAge Generator Templates (VAGT) enhancements, problem support, or limitations for the following:

· Import/Export Function

This function has been redesigned and optimized. Extensions can now be exported or imported.

· Relational Import

Oracle 8 support
Relational Import: Comments on columns are now imported from Windows NT databases.

· VAGT Workbench

The VAGT Browser window now includes a third pane (to manage packages/applications).
New VAGT Duplicate Browser window.
On the Select Workspace window, the 'Manager' is now displayed.

· Generated Web Client

You can now display a list and a detail with the same Business Object in a single Interface Unit.
The "Save" action is now implemented.

· Generated GUI Client

Workspace: layout margins and gaps, letter width, client object style, information messages are now taken into account on Java platform also.
ValueStyle are now taken into account on the Java platform.
Updatable lists are now available on the Java platform as well.

· Generated TUI

TUI Generators are now available on Java platform also.

· Generation

'Reset' and 'Overwrite' options are now available on Java platform also.
Java platform: the Registry Browser has been enhanced.

VisualAge Generator Templates Standard Functions Installation

To install VAGT Standard Functions, select the corresponding option in the VisualAge Generator 4.0 install.

Installation Note:

VisualAge Generator Templates (Standard Functions) will be installed with VisualAge Generator Developer if the user choose VAGT to install when prompted during VisualAge Generator installation. The IBM VisualAge Generator feature is a prerequisite of VisualAge Generator Templates. Make sure that it is already loaded.

Adding the VisualAge Generator Templates feature on Java:

Note: If users have already added the VAGT feature to their existing VAGen installation, the VAGT feature will have been already migrated. The following section only applies to those who want to add VAGT feature for the first time.

On the Workbench, select File>>Quick Start.
On the Quick Start dialog, select Features on the left. Add Feature on the right, and then select OK.
Select IBM VisualAge Generator Templates 4.0 + FP1, and select OK (this will take a few minutes).
Close the Workbench, and, then, close the Log. You will be prompted to save the workspace. Select OK to save the workspace.

Loading the VisualAge Generator Templates feature on Smalltalk:

Before starting the workspace, you should consider saving a copy of the VisualAge Smalltalk image named abt.icx.
Start VisualAge for Smalltalk.
Select Tools>>Load/Unload Features... on the System Transcript.
In the Selection Required window:

Make sure that "Show other features" is checked.
Select Other: VAGTemplates 4.0 + FP1 from the Available features list.
Click on the OK button. VisualAge Generator Templates 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.

Once VisualAge Generator Templates is loaded, you will be prompted to save your image. Click the Yes button so you won't have to load VisualAge Generator Templates 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.

Notes Limitations and Known Problems with VAGT

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 should not display more than one business object in one interface unit.
Relational Table: 'Concurrency Management' is not handled in the web client generated (with 'Xfer' style).

GUI Generators:

The '4GL' Client Logic Style (Workspace Parameter) is not implemented.

Templates on Java Limitations

Generation:

If you don't use the QuickStart or a VAGT workspace produced by the QuickStart, unload the project 'IBM VAGT QuickStart Runtime'.

GUI Generators:

In VA Java, You need to check 'Inherit BeanInfo of Bean superclass'in the panel 'Options', under 'Visual Composition' to have your generated GUI work properly.
GUI Online Help Generators are not available.
Relational Table: The 'read' concurrency management is not supported by the client.
No BiDi support.

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's 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 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

Note:

Be aware that this will also roll back all units of work.

Installation Troubleshooting

If you get a installation error -115 during the installation, please reboot the machine and try the installation again. This condition occurs in isolated cases where there are stray processes running in the system.
On NT, towards the end of the installation of Developer on Java or Smalltalk, a small command prompt window will come up with an empty screen. This is normal behavior. The installation program is configurating the Net Question help system on your behalf.
After installing a VisualAge Generator FixPak and loading the FixPak feature, both the FixPak feature and the base product feature will appear in the Available features list instead for the Loaded features list in the Load/Unload Feature window. This is misleading as the features are actually loaded in the Smalltalk image. The FixPak files will overlay files in the file directory tree structure where your current VisualAge installation resides.

For additional information, see the VisualAge Smalltalk webpage

VisualAge Generator Redbook

For additional information on developing VisualAge Generator applications, you can access the redbook VisualAge Generator System Development Guide (SG24-4230) on the web.

Online Documentation

Most of the VisualAge Generator manuals are installed with the online help in HTML format. They are also available in PDF format on the product CD. Updates for these books will be made periodically. The search capability has been enabled for Japanese online help. The most up-to-date versions are available for download at no cost from our website: http://www.ibm.com/software/ad/visgen/library/v4docs.html.

Useful Websites:

Table of Contents