|
IBM VisualAge Generator
V4.0 FixPak1 Readme
PTF #: UQ41558
|
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.
VisualAge Generator V4.0 FixPak1 contains enhancements,
problem support, and limitations for the following:
- 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/.
- 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 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.
- 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.
- 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".
- 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.
- 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.
- 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.
- 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/.
- 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.
The search capability for Japanese online help
has been enabled for Windows NT-based Developer.
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.
- 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.
- 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.
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.
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.
- 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.)
- 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 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, 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.
- 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."
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
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.
- 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 V4.0 fixpak1 contain VisualAge Generator
Templates (VAGT) enhancements, problem support, or limitations for the
following:
- This function has
been redesigned and optimized. Extensions can now be exported or
imported.
- Oracle 8 support
- Relational
Import: Comments on columns are now imported from Windows NT
databases.
- 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.
- 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.
- 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.
- TUI Generators are
now available on Java platform also.
- 'Reset' and
'Overwrite' options are now available on Java platform also.
- Java platform:
the Registry Browser has been enhanced.
To install VAGT Standard Functions, select the corresponding
option in the VisualAge Generator 4.0 install.
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.
- 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.
|
- 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
For additional information on developing VisualAge Generator
applications, you can access the redbook
VisualAge Generator System Development Guide (SG24-4230) on the web.
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.