Setting up jGRASP at home:

Download and install the Java JDK1.3 from Sun (http://java.sun.com/j2se/1.3/download-windows.html). Run it and follow the directions. Also, you can download and install the documentation from a link on that page (optional).

Download and install jGRASP from Auburn (http://www.eng.auburn.edu/csse/research/research_groups/grasp/). Get the version for Windows without the JRE (it's a lot smaller). Run it and follow the directions. You will not need to install the administrator settings option.

In unusual cases, in order for jGRASP to integrate with Windows properly, you need to edit your system path variable to include the "bin" directory for wherever you installed the JDK. Usually, this will not be necessary. On Win95/95 this can be accomplished by selecting Start/Run, entering "sysedit" and OK, editing the path line in the autoexec.bat file and saving it, and then restarting the machine. On Win2000, just select Start/Settings/Control Panel/System, click the Advanced tab, press the Environment Variables button, select the Path variable from the System variables, then press the Edit... button. Make the addition, then click OK, OK, and OK again. No need to restart Win2000.

If you want to use the Jikes compiler (optional), download it from IBM (http://oss.software.ibm.com/developerworks/opensource/jikes/project/download/shields/), and run it to unzip the files.

Run jGRASP. Under the Settings menu, choose Global CSD Window Settings. Under language, choose Java. Choose "jdk 1.3 generic" and press the Copy button. You should see a dialog that looks like the one below:

Give the configuration a good name, and then fill in the boxes similar to those shown above. These are the settings we use here at Otterbein. At home, you should use whatever directory you installed JDK1.3 into instead of "N:\Java\jdk1.3". (If you also want to set up Jikes (optional), update its location on the C/L line instead of "N:\Java\ibm-compiler".) The "Error Format" column should already be OK, except for the C/L line (for Jikes).

The entire V1 line is:
N:\Java\jdk1.3\jre\lib\rt.jar;N:\Java\jdk1.3\jre\lib\jaws.jar;N:\Java\jdk1.3\jre\lib\i18n.jar;N:\Java\jdk1.3\lib\dt.jar;N:\Java\jdk1.3\lib\tools.jar

The entire V2 line is:
N:\Java;n:\java\jaf-1.0.1\activation.jar;n:\java\javamail-1.1.3\mail.jar;n:\java\pop3-1.1.1\pop3.jar;N:\Java\jswdk-1.0-ea\lib\servlet.jar;N:\Java\NetComponents-1.3.8a\NetComponents.jar;N:\Java\InstantDB\Classes\idb.jar;N:\Java\InstantDB\Classes\idbf.jar;N:\Java\InstantDB\Classes\idbexmpl.jar

Here, you should again use your own directory paths. The line V1 is only required for Jikes. The line V2 should list only optional packages you have installed, so it may be empty.

Click OK so save your updates, and then click on the "Flags/Ags/Main" tab. Enter the text boxes as shown below:

You have to click the black box to be able to enter your own value (overriding the default).

Click OK, and you should be in business!

Usage:
You should only have to edit the Flags/Args/Main window in the future. You can add your own directories to the classpath if you need to. That's only required if you are using packages. Add it to all the commands.

Note that by default the Run command runs the current file. If you select Run/Run Arguments you get a line on which you should enter the name of the main class followed by any arguments it requires. If you use the Run/Run Arguments option you MUST enter the name of the main class, even if it is the same as the file. The payoff is that if you're working on one class, but another class is the main class, you can still easily run the main class without having to open it. The Run/Run Arguments setting applies to the current file, and will be remembered between sessions.