You may want to print off this page for convenient reference.

Introduction to directory structure:

There are three points to note about the PSP Java download ZIP files discussed further below:

• All the ZIP files mentioned below have directories included. You should always UNZIP the files so that you preserve the directory structure. If you UNZIP such that the directory structure in the ZIP files is lost, you will undoubtedly have problems using our Java software.
• The top-level directory in the ZIP files is a combination of product identifier and version number. For example pspnum44 for version 4.4 of our PSPNum product. We strongly suggest you preserve this top-level directory name when you UNZIP the files. You can then easily switch between different versions of one of our products if you wish.
• You can UNZIP all the ZIP files (preserving directory structure as described above) to the same location. Some objects may appear in more than one ZIP file. So an object from one UNZIP may be overwritten by a file from a subsequent UNZIP. This is not a problem. The duplication of objects in ZIP files is deliberate. We give you multiple ZIP files so that you can pick just the functions/documentation you want, rather than giving you one huge ZIP file containing everything.

Installing PSPNUMDEMO1.ZIP:

You should see pspnumdemo1.jar after the UNZIP. All classes in this jar file are prefixed uk.co.prosperoassociates.pspnumdemo. This means that if you wish to use these classes, you should have a line of code such as import uk.co.prosperosoftware.pspnumdemo.*; in your Java source code.

It is fairly unlikely that you would want to write your own Java code using pspnumdemo classes. Instead you are more likely just to run the standard demos we provide. You should be able to use the demos where they were UNZIPped - it should not be necessary to move any objects to another directory. To run a demo, first try loading the PSPNumDemo1.html or PSPNumDemo2.html files in your browser. These two HTML files can be found in the pspnumdemo subdirectory.

Installing PSPNUM1DOC.ZIP:

After the UNZIP, the best place to start with documentation is the file overview-summary.html you can find in the docs\javadocs subdirectory.

Installing PSPNUM1.ZIP, PSPNUM2.ZIP, PSPNUM3.ZIP and PSPNUM4.ZIP:

People usually download only one of these ZIP files, but more than one is not a problem provided you UNZIP as described above. You should see one or more of: pspnum1.jar, pspnum2.jar, pspnum3.jar and pspnum4.jar after the UNZIP. All classes in these jar files are prefixed uk.co.prosperoassociates.pspnum. This means that if you wish to use these classes, you should have a line of code such as import uk.co.prosperosoftware.pspnum.*; in your Java source code.

Setting CLASSPATH:

This section applies only if you want to develop your own Java code using pspnum or pspnumdemo classes - it should not apply if you simply want to run PSPNum demos or just browse the documentation we provide.

With different versions of the JDK (the Java Development Kit), there are various ways of setting the CLASSPATH variable e.g. via a command-line switch or environment variable. However you set the CLASSPATH variable, you need to add in the path up to the top-level UNZIPped directory from the ZIP files above. For example if you have UNZIPped to the top level of your D: drive, then you need to add D:\pspnum44 to your CLASSPATH (assuming pspnum44 is the top-level directory from the ZIP files). For example:

Setting the CLASSPATH variable in this way should pick up all objects (both .jar and .class files) correctly. An alternative is to copy the .jar files we provide into another directory which is already in your CLASSPATH path e.g. if JDK1.2.2\LIB is in your classpath, copy the .jar file(s) there. Note that most of our ZIP files below contain both .jar and .class files. The .class files are also in the .jar files. So why do you need the .class files separately in the ZIP file ?. Our testing indicates that some Java development environments can not always dig out the classes from .jar files correctly - they look for the .class files direct. So we give you both. In your environment, you may find that you can use our .jar files only, in which case you are welcome to remove the .class files we provide.

Deinstalling PSP Java objects:

Locate and delete directories/objects prefixed pspnum or pspnumdemo. Of course you should check that the objects you delete in this way are indeed the ones you downloaded from our web site.