JAMM Installation
This section covers installation of JAMM.
System Requirements
rJAMM requires the installation of Swing
and either the Java
Runtime Environment 1.1.x (JRE) or the Java
Development Kit 1.1.x (JDK) .
The Complete JAMM distribution file comes with
all of these required components.
The small JAMM
distribution file of version 0.7
or 0.7c requires you to also install
both Swing
and either JRE or JDK. JAMM has not been tested on any
other Java virtual machines, but may work if you follow the Small
JAMM distribution installation and modify them to suit your
virtual machine.
Installation Instructions
Easy JAMM distribution
installation
Follow these instructions if you have downloaded the
large JAMM 0.7c
distribution file.
This installation is simpler than the Small
JAMM distribution installation.
rJAMM Distribution Directory Structure
Extract the distribution file
wherever you desire. The uncompressed files use approx 6 MB
of space on DOS and approx 16 MB of space on Solaris (JRE is large on
Solaris).
The top level directory of the rJAMM distribution
is named rJAMM<version> (where <version> is the
rJAMM version number); it contains the following
subdirectories:
-
bin
-
UNIX scripts and DOS batch files to run rJAMM
-
classes
-
rJAMM Java class files
-
config
-
Files needed to configure your Java environment to use rJAMM
-
doc
-
rJAMM documentation
-
jars
-
Notepad and Stylepad jar files, modified from Swing for serializability
-
swingoverride
-
Modified Swing classes needed for serialization (object copying).
-
JDK1.1override
-
Modified Java 1.1 classes needed for serialization.
java.util.EventListener
-
swing-0.7
-
The unmodified Swing 0.7 jar files.
-
jre1.1.5
-
The Java Runtime Environment (JRE) version 1.1.5.
Configuring rJAMM
The
rJAMM<version>/bin directory contains a script (batch file) for
setting the environment variables needed by rJAMM, called
rJAMMconfig (or for DOS: rJAMMconfig.bat). You
must edit this file to make it point to the directory into which you
installed JAMM. Only the JAMM_HOME variable
must be changed.
(Note,
the UNIX scripts are bourne shell scripts; use ${HOME} to indicate
your home directory, not ~ as in csh). If you use a relative path
name (e.g., ../../<something>), the starting point of the path is the
rJAMM<version>/bin directory.
- JAMM_HOME
- should be set to the JAMM installation directory. e.g., on UNIX
${HOME}/rJAMM<version>, and on DOS c:\rJAMM<version>
Configuring MS DOS
The MS DOS batch files used to run rJAMM set several environment variables
related to portions of the classpath. In order to have enough environment
space, set the environment memory to 4096 bytes by adding or modifying
the following line in your C:\CONFIG.SYS file and restart your machine:
shell=c:\windows\command.com c:\windows /p /e:4096
Alternatively, you may make a shortcut to the MS-DOS command in
Windows 95/NT.
Then, under Properties->Memory->Initial Environment,
select 4096. Open the DOS window from which you will run the batch
files from this shortcut. You may also make this modification to
the properties of the distributed batch files.
All Done
To use JAMM, read the JAMM User's Guide.
Small JAMM distribution installation
Follow these instructions if you have downloaded the small JAMM
distribution file of version 0.7
or 0.7c.
This installation is more complex than the Easy JAMM distribution installation.
rJAMM Distribution Directory Structure
Extract the distribution file
wherever you desire. The uncompressed files use less than 1.5 MB
of space. The top level directory of the rJAMM distribution
is named rJAMM<version> (where <version> is the
rJAMM version number); it contains the following
subdirectories:
-
bin
-
UNIX scripts and DOS batch files to run rJAMM
-
classes
-
rJAMM Java class files
-
config
-
Files needed to configure your Java environment to use rJAMM
-
doc
-
rJAMM documentation
-
jars
-
Notepad and Stylepad jar files, modified from Swing for serializability
-
swingoverride
-
Modified Swing classes needed for serialization (object copying).
-
JDK1.1override
-
Modified Java 1.1 classes needed for serialization. java.util.EventListener
Configuring your Java Environment
After
extracting the rJAMM distribution file, your
installation of
JRE or JDK
must be configured to use the rJAMMEventQueue
class instead of the usual AWTEventQueue class.
For UNIX, the script rJAMM<version>/bin/linkJDK
will create a link to your JRE or JDK installation in
rJAMM<version>/jdk1.1-rJAMM . If you use this, use
rJAMM<version>/jdk1.1-rJAMM as the JAMM_JDKHOME
environment variable in Configuring rJAMM
procedure below. The syntax is:
usage: linkJDK <REAL_JDK_HOME>
where <REAL_JDK_HOME> is the JRE or JDK installation root on this host
For MS DOS, follow these steps (assumes JDKHOME is your
original JRE or JDK installation directory. e.g., c:\jdk1.1 or c:\jre\1.1 ):
copy %JDKHOME%/lib/awt.properties
%JDKHOME%/lib/awt.properties.original
copy rJAMM<version>/config/awt.properties
%JDKHOME%/lib/awt.properties
Configuring MS DOS
The MS DOS batch files used to run rJAMM set several environment variables
related to portions of the classpath. In order to have enough environment
space, set the environment memory to 4096 bytes by adding or modifying
the following line in your C:\CONFIG.SYS file and restart your machine:
shell=c:\windows\command.com c:\windows /p /e:4096
Alternatively, you may make a shortcut to the MS-DOS command in
Windows 95/NT.
Then, under Properties->Memory->Initial Environment,
select 4096. Open the DOS window from which you will run the batch
files from this shortcut. You may also make this modification to
the properties of the distributed batch files.
Configuring rJAMM
The
rJAMM<version>/bin directory contains a script (batch file) for
setting the environment variables needed by rJAMM, called
rJAMMconfig (or for DOS: rJAMMconfig.bat). You
must edit this file to make it point to the JRE or JDK and Swing
installations on your machine. Only the variables JAMM_HOME,
JAMM_JDKHOME and SWINGHOME must be changed. (Note,
the UNIX scripts are bourne shell scripts; use ${HOME} to indicate
your home directory, not ~ as in csh). If you use a relative path
name (e.g., ../../<something>), the starting point of the path is the
rJAMM<version>/bin directory.
- JAMM_HOME
- should be set to the JAMM installation directory. e.g., on UNIX
${HOME}/rJAMM<version>, and on DOS c:\rJAMM<version>
- JAMM_JDKHOME
- should be set to the JRE or JDK installation
you created previously in Configuring the Java
Development Kit, e.g., on UNIX
${HOME}/rJAMM<version>/jdk1.1-rJAMM ; or on
DOS c:\jre\1.1 or c:\jdk1.1 .
- SWINGHOME
- should be set to the root of your Swing installation, e.g.,
on UNIX, ../../swing-0.6.1 or ../../swing-0.5.1 ; or on DOS
c:\swing-0.6.1 or c:\swing-0.5.1 .
All Done
To use JAMM, read the JAMM User's Guide.
Top Level JAMM
JAMM Home
James "Bo" Begole
begolej@vt.edu
Last modified: Wed Feb 4 22:00:42 EST