IBM VisualAge Generator
V4.0 FixPak1 Readme
PTF #: UQ41558
Table of Contents
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:
1.From the Quick Start menu, choose Delete Feature.
2.Select IBM VisualAge Generator 4.0 + FP1 and IBM VisualAge Generator Utilities 4.0 + FP1.
3.Select OK.
4.Save the workspace and exit VisualAge.
5.At this point you can install a newer version of VAGen.
6.Start IBM VisualAge for Java.
7.Add the feature IBM VisualAge Generator 4.0 + xxx (where 4.0 + xxxx is the installed version).
8.Save the workspace and exit VisualAge.
9.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.
1.<%@ page import = "com.ibm.vgj.uibean.VGDataElement" %>
becomes
<%@ import="com.ibm.vgj.uibean.VGDataElement" %>
2.
becomes
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:
1.Edit the xxx.ftp file (where xxx is the application name) and add quit to the last line.
2.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:
1.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.
2.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.
3.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:\\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:
1.hptcfg remove /p hptsjhlp
2.hptcfg install /multiple /lang ja_JP /w x:\\doc\vghelpj
3.imnss stop server
4.imqss -stop dbcshelp
5.imqss -start dbcshelp
6.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:
1.Start VisualAge for Smalltalk.
2.Select Tools --> Load/Unload Features... on the System Transcript window.
3.On the Selection Required window, do the following:
4.Ensure that the Show other features check box is checked.
5.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.
6.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.
7.Click on the OK button. The selected features will be imported and loaded into your image.
8.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...).
9.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:
1.Create a temporary directory on your hard drive.
2.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.
3.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).
4.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 \xxx\HPTDEVS2, where 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 \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:
1.Start VisualAge for Smalltalk.
2.Select Tools --> Load/Unload Features... on the System Transcript window.
3.On the Selection Required window, do the following:
4.Ensure that the Show other features check box is checked.
5.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.
6.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.
7.Click on the OK button. The selected features will be imported and loaded into your image.
8.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...).
9.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:
1.Create a temporary directory on your hard drive.
2.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.
3.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).
4.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 \xxx\HPTWGS2, where 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 \xxx\HPTWGS2, where "xxx" is the 3-character NLS ID for your language.
FixPak1 for Common Services V4.0 is a prerequisite for running Server 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:
1.Create a temporary directory on your hard drive.
2.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.
3.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).
4.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 \xxx\HPTCSO2, where 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 \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.
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 4.0 + FP1, 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.
Loading the VisualAge Generator Templates feature on Smalltalk:
1.Before starting the workspace, you should consider saving a copy of the VisualAge Smalltalk image named abt.icx.
2.Start VisualAge for Smalltalk.
3.Select Tools>>Load/Unload Features... on the System Transcript.
4.In the Selection Required window:
1.Make sure that "Show other features" is checked.
2.Select Other: VAGTemplates 4.0 + FP1 from the Available features list.
3.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:
IBM VisualAge Generator
http://www.software.ibm.com/ad/visgen/
IBM VisualAge Smalltalk
http://www.software.ibm.com/ad/smalltalk
IBM VisualAge Java
http://www.software.ibm.com/vajava
IBM VisualAge Resource Catalog
http://www.software.ibm.com/ad/visage/rc
IBM Software Applicaiton Development
http://www.software.ibm.com/ad
IBM Software Homepage
http://www.software.ibm.com
IBM Corporation Homepage
http://www.ibm.com