Installation

SPA can be installed anywhere on the disk. The most common practice is to place the source code and executables into /usr/local/SPA. If so, you will need to become the superuser to write into the /usr disk partition and to create the symbolic links in /usr/local/bin/. All of the SPA source code and utilities are contained within the compressed Unix tar file spa.tar.Z. If you have received a copy of SPA on a 1.4 Mb floppy, then move into the directory in which you wish to install SPA and type: % setenv SPADIR /mydirectory where mydirectory is the location you have chosen to keep the program. % cd SPADIR % tar xvf /dev/fd0c spa.tar.Z; uncompress spa.tar.Z or, if you have received a copy of the spa.tar.Z directly over the network, type: % uncompress spa.tar.Z Finally, to extract the source files, % tar xvf spa.tar

Before creating the object library and executable programs, a few changes must be made to the source code which reflect the local environment.

1. Edit the spa startup scripts spi.csh, spa.csh and dar.csh. Change the paths of the executable files to mydirectory/bin. Change the environment variable TAPE1 to reflect the name of local tape drive.
2. Copy biniee.SUN to biniee.f so that the IEEE floating point routines are compiled into the program.
3. If you are using Sun FORTRAN 1.3, a patch must be activated within several subroutines to overcome a severe compiler bug. The bug writes an end-of-file after the last accessed record within the SPA data file. Depending on what you are doing with SPA, the last record could be the first in which case the compiler bug would destroy all remaining data! The subroutine SUNPATCH reads the last record in the data file to ensure that no data is destroyed. To activate the patch, edit the files sdirec.f and spi.pgm and uncomment the appropriate blocks of code. Later versions of the Sun FORTRAN compiler have corrected for this bug.

To create the object library and executable programs, type: % cd SPADIR/spasrce % make spa % make spi % make dar By default, the SPA startup scripts are stored in the SPADIR directory. You may wish to create a symbolic link in /usr/local/bin to point to the SPA startup scripts. These are created by typing: % make links