[Unix | Windows 95/98 | Windows NT]

Unix

1. Find the directory you originally installed jdsl into -- for example, $HOME/jtools.
2. Move the JDSL file you downloaded to $HOME/jtools and make $HOME/jtools your working directory (cd into it).
3. Expand the JDSL file as follows: To expand filename.zip:

   unzip filename.zip

   Directory $HOME/jtools will now contain a jdsltools directory. We will refer to $HOME/jtools/jdsltools as JDSLHOME for the rest of this discussion.
   
4. Find the configuration file in your home directory that has the string setenv CLASSPATH pathlist. This file is usually $HOME/.cshrc or ~/.cshrc. The string pathlist could be almost anything -- for example, it might be setenv CLASSPATH .:/usr/lib/java
   
5. If you downloaded the sources, add :JDSLHOME/jdsltools/visualization to the end of that string. (Note that there is a colon at the beginning of the string.) So, if you originally had setenv CLASSPATH .:/usr/lib/java and you installed JDSL in $HOME/jtools, then you should now have

   setenv CLASSPATH .:/usr/lib/java:/$HOME/jtools/jdsltools/visualization

   (Make sure not to add a line-break in the middle of the line while doing this.)
6. Save the file.
7. If you downloaded the jar file, add :JDSLHOME/jdsltools/jdslviz.jar to the end of that string. (Note that there is a colon at the beginning of the string.) So, if you originally had setenv CLASSPATH .:/usr/lib/java and you installed JDSL in $HOME/jtools, then you should now have

   setenv CLASSPATH .:/usr/lib/java:/$HOME/jtools/jdsltools/jdslviz.jar

   (Make sure not to add a line-break in the middle of the line while doing this.)
8. Save the file.
9. You will need to re-source your configuration file for any shell from which you wish to use the JDSL classes during this login session. (If you are using csh, type

   source $HOME/.cshrc

   into that shell, substituting in the name of the file you modified.)
10. You can remove the zip file, if you wish.
11. Now you can run the JDSL visualizer by typing
    

    JDSLHOME/jdslviz

Windows 95/98

1. Find the directory you originally installed jdsl into -- for example, C:/jtools.
2. Expand the JDSL file, storing the expanded files in C:/jtools (we recommend using WinZip) Directory C:\jtools will now contain a jdsltools directory. We will refer to C:\jtools\jdsltools as JDSLHOME for the rest of this discussion.
   
3. Edit your AUTOEXEC.BAT file (usually C:\WINDOWS\AUTOEXEC.BAT). You can either do this using msconfig.exe (available from a menu in the System properties control panel) or with a text editor (for example, Notepad). Do not edit it with a word processing program.
4. Find the string SET CLASSPATH=pathlist. The string pathlist could be almost anything -- for example, it might be SET CLASSPATH=.;%JAVA_HOME%\lib\classes.zip. If there is no such string, add the string SET CLASSPATH= as a new line.
5. If you downloaded the sources, add ;JDSLHOME/jdsltools/visualization to the end of that string. (Note that there is a semicolon at the beginning of the string.) So, if you originally had SET CLASSPATH= .:/usr/lib/java and you installed JDSL in C:/jtools, then you should now have

   SET CLASSPATH= .;/usr/lib/java;C:/jtools/jdsltools/visualization

   (Make sure not to add a line-break in the middle of the line while doing this.)
6. Save the file.
7. If you downloaded the jar file, add ;JDSLHOME/jdsltools/jdslviz.jar to the end of that string. (Note that there is a semicolon at the beginning of the string.) So, if you originally had SET CLASSPATH= .;/usr/lib/java and you installed JDSL in C:/jtools, then you should now have

   SET CLASSPATH= .;/usr/lib/java;C:/jtools/jdsltools/jdslviz.jar

   (Make sure not to add a line-break in the middle of the line while doing this.)
8. Save the file.
9. You will need to restart, in order to use JDSL.
10. You can remove the zip file, if you wish.
11. Now you can run the JDSL visualizer by typing
    

    JDSLHOME/jdslviz.bat

    
    or by clicking on jdslviz.bat in windows.

Windows NT

1. Find the directory you originally installed jdsl into -- for example, C:/jtools.
2. Expand the JDSL file, storing the expanded files in C:/jtools (we recommend using WinZip) Directory C:\jtools will now contain a jdsltools directory. We will refer to C:\jtools\jdsltools as JDSLHOME for the rest of this discussion.
   
3. Double-click the System icon inside the Control Panel. When the System Properties dialog box opens, choose the Environment tab. At this point you need to find where you have already set your classpath for JDSL, and to add to that classpath. It may either be in the System Variables or User Variables. Find the variable named CLASSPATH which has JDSLHOME in it. The string for the pathlist could be almost anything -- for example, it might be CLASSPATH .;%JAVA_HOME%\lib\classes.zip. Then, if you downloaded the source code click on that variable and add ; JDSLHOME/jdsltools/visualization to the end of pathlist, using the text-editing boxes below the list. So if you originally had CLASSPATH .;%JAVA_HOME%\lib\classes.zip and you installed JDSL in C:\jtools, then you should now have

   CLASSPATH .;%JAVA_HOME%\lib\classes.zip;C:/jtools/jdsltools/visualization

Alternatively, if you downloaded the jar file click on that variable and add ;JDSLHOME/jdslviz.jar; to the end of pathlist, using the text-editing boxes below the list. So if you originally had CLASSPATH .;%JAVA_HOME%\lib\classes.zip and you installed JDSL in C:\jtools, then you should now have

CLASSPATH .;%JAVA_HOME%\lib\classes.zip;C:/jtools/jdslviz.jar

4. Click Set and then OK at the bottom-right of the dialog.
5. Now JDSL should be installed. You will need to log out and log back in, in order to use JDSL.
6. You can remove the zip file, if you wish.
7. Now you can run the JDSL visualizer by typing
   

   JDSLHOME/jdslviz.bat

   
   or by clicking on jdslviz.bat in Windows