# JAMM Installation

This section covers installation of JAMM.

#### System Requirements

#### Installation Instructions

- #### Easy JAMM distribution installation (easier)

  1. #### Directory Structure

  2. #### Configuring JAMM

- #### Small JAMM distribution installation (harder)

  1. #### Directory Structure

  2. #### Configuring JDK

  3. #### Configuring MS DOS

  4. #### Configuring 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.

  1. #### 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.

  2. ### 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>`

  3. ### 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.

  4. ### 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.

  1. ### 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

  2. ### 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`

  3. ### 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.

  4. ### 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` .

  5. ### All Done

     To use JAMM, read the JAMM User's Guide.

### JAMM User's Guide

Top Level JAMM
JAMM Home