The EGL runtime code for generated Java™ applications
is in the Rational® Business
Developer plugins directory. The plugins directory
is located in the product shared resources directory.
The runtime code is located in the following plug-in JAR file:
com.ibm.etools.egl.java.binaries_version.jar
- version
- Current version of the product.
The following distributed platforms are supported:
- AIX®
- HP-UX
- Linux® (Intel®)
- Linux (zSeries®)
- iSeries®
- Solaris
- USS
- Windows® 2000/NT/XP
See product prerequisites for supported versions. EGL provides
32- and 64-bit support for AIX,
HP-UX, and Solaris. Linux for zSeries support is 64–bit only.
The runtime code includes the following:
- JAR files which contain Java code
that is common to all supported distributed platforms
- Platform-specific code
Do as follows:
- Extract the files to each system on which deployed EGL applications
are to be run.
- Include the JAR files in the CLASSPATH of the deployment systems.
Here are the files:
- fda7.jar is required for all uses and is in com.ibm.etools.egl.java.runtime_version,
where version is the product version.
- fda6wrappers.jar is needed if you used Java wrappers in EGL version 6.x, are regenerating
the wrappers in EGL 7.x, and wish to avoid updating the native Java code that invokes the wrappers.
In this case, set the build descriptor option wrapperCompatibility to V6 at
generation time, as noted in the help topic for that option.
The
file fda6wrappers.jar is in the same location as fda7.jar.
- hpt.jar is needed in two cases:
- You are running Web transactions; or
- You used Java wrappers in VisualAge® Generator version
4.x or 5.x, are regenerating the wrappers in EGL 7.x, and wish to
avoid updating the native Java code
that invokes the wrappers. In this case, set the build descriptor
option wrapperCompatibility to V4 or V5,
as appropriate. For details, see the help topic for that option.
The file hpt.jar is in com.ibm.etools.egl.java.runtime_version\webtrans,
where version is the product version.
- hpt.gateway is also needed if you are running Web transactions.
The file is in the same location as hpt.jar.
- vgjwgs.jar is needed if you are running Web transactions that
were generated with VisualAge Generator
4.x.
- Copy any platform-specific code to a directory on each deployment
system; and set environment variables for each of those systems as
appropriate:
- For AIX (32- or 64-bit support)
- The files of interest are in the directory Aix or
(for 64-bit support) Aix. Change the PATH and
LIBPATH environment variables so they reference the directory that
contains the platform-specific code you copied from the Web site.
- For HP-UX (32- or 64-bit support)
- The files of interest are in one of the following four directories:
- For ITanium processors:
- HPUXItanium
- HPUX64Itanium (for 64-bit support)
- For RISC processors:
- HPUXRisc
- HPUX64Risc (for 64-bit support)
Change the PATH and LD_LIBRARY_PATH environment variables
so they reference the directory that contains the platform-specific
code you copied from the Web site.
- For iSeries
- The files of interest are in the directory iSeries.
In qshell, change to the directory you just uploaded the files to
and run the setup.sh script with the "install" option:
- > setup.sh install
- In addition, some other environment variables must be set. For
information on how to set these environment variables, run the script
with the "envinfo" option:
- > setup.sh envinfo
- If for some reason you delete a symlink that is created for you
during install, you can recreate it with the "link" option:
- > setup.sh link
You also need to set
the LIBPATH environment variable.
- For Linux (Intel hardware)
- The required files are in the directory Linux. Change
the PATH and LD_LIBRARY_PATH environment variables so they reference
the directory that contains the platform-specific code you copied
from the Web site.
- For Linux (zSeries hardware)
- The required files are in the directory Linux. Change
the LD_LIBRARY_PATH environment variable so it references the directory
that contains the platform-specific code you copied from the Web site.
(EGL provides no executable programs for this platform, so it does
not require the PATH variable.)
- For Solaris (32- or 64-bit support)
- The files of interest are in the directory Solaris or
(for 64-bit support) Solaris64. Change
the PATH and LD_LIBRARY_PATH environment variables so they reference
the directory that contains the platform-specific code you copied
from the Web site.
- For USS
- The files of interest are in the directory USS.
Change the PATH and LIBPATH environment variables so they reference
the directory that contains the platform-specific code you copied
from the Web site.
- For supported Windows platforms
- The files of interest are in the directory Win32.
Change the PATH environment variable so it references the directory
that contains the platform-specific code you copied from the Web site.