The samples provided in the distribution are already
compiled so you are not required to compile them to be able to run
them. If you want to modify a sample and recompile it, every sample
contains a
build.xml file so that
you can compile and run the sample. This file is an Ant project file.
Ant is a Java-based build tool that is developed by the Apache Software
Foundation (see
http://ant.apache.org.)
The distribution contains a version of Ant that you can use if you
do not have Ant already installed on your computer. The Ant installation
can be found in the
<installdir>/jviews-framework89/tools directory.
To use Ant, you must set the following environment variables:
The build.bat and build.sh scripts
use the version of Ant provided in the distribution. If you use these
scripts, you do not set any other environment variables. If you want
to run Ant directly, for example to use your own Ant installation,
then you must set:
ANT_HOME to
point to your Ant directory.
Add the Ant
bin directory to your PATH.
To recompile a sample, go to the samples directory and
enter the command:
build.bat
(or build.sh on UNIX®
and Linux®).
Alternatively, if you use Ant directly:
ant clean
The samples that can run as applications also have a run target
in their build.xml files and run.[bat|sh] batch
files:
run.bat
(or run.sh on UNIX and
Linux).
Alternatively, if you use Ant directly:
ant run
For more information on how to use the build.xml file
of a sample use:
ant -projecthelp
Applet memory requirements
To browse all the Java applets displayed in the Product
guide, you might have to modify the settings in your IBM®
or Sun™
Java
plug-in to increase the amount of permanent generation memory available
for applets.
Exit your browser before making any
changes.
Run the Java plug-in
Control Panel.
On Microsoft®
Windows®
systems, use Start >
Control Panel > Java.
On Linux®
systems,
run the shell script ControlPanel in
the bin/ directory of the Java
installation.
On Macintosh®
systems,
use Finder to access Applications >
Utilities > Java and then run Java
Plugin Setup.
Select the Java tab
and click View in Java
Applet Runtime Settings.
In the table of available JREs, select
the row containing the JRE that is used in your browser. If you are
unsure which JRE to choose, select all installed Java versions, that
is, all rows in the table.
In the column headed Java
Runtime Parameters enter:
-XX:MaxPermSize=256m
Click OK.
Click Apply or,
on Macintosh systems, click Apply Now.
This setting allocates up to 256 MB of permanent generation
memory to your browser.