SCANUAF V2.0 AAAREADME.1ST file.
Jim Snyder - Princeton Plasma Physics Laboratory
Internet: JSNYDER@PPPL.GOV
18-JAN-1994


Other Files In This Directory
-----------------------------

ARTICLE.TEX              - _DEC Professional_ TeX article describing SCANUAF.
BUILD_SCANUAF.COM        - Command procedure to compile and link SCANUAF.
SCANUAF.EXE_AXP          - SCANUAF executable image (AXP version).
SCANUAF.EXE_VAX          - SCANUAF executable image (VAX version).
SCANUAF.FOR              - SCANUAF source code file.
SCANUAF.HLP              - SCANUAF help file.
SCANUAF.INC              - SCANUAF source code include file.
SCANUAF.NODES            - Text file describing location of SYSUAF.DAT files.
SCANUAF.OBJ_AXP          - SCANUAF object code (AXP version).
SCANUAF.OBJ_VAX          - SCANUAF object code (VAX version).
SCANUAF.USER_GUIDE       - SCANUAF user guide.
SCANUAF020.RELEASE_NOTES - Release notes for this version of SCANUAF.


SCANUAF Installation Instructions
---------------------------------

1) Read the release notes file SCANUAF020.RELEASE_NOTES, especially if you are
   currently using a previous version of SCANUAF.

2) Execute BUILD_SCANUAF.COM to compile and link the SCANUAF executable.
   This will work on both VAX and AXP platforms.  Object code and executable 
   code are included for each platform with this distribution in case you 
   don't have a Fortran compiler and/or you don't want to relink for some 
   reason.

3) Edit the file SCANUAF.NODES to include your list of node names and
   authorization file locations.  See section 2.8 of the user guide.
   The sample SCANUAF.NODES included with the distribution shows some
   possible syntax specifications for pathnames for authorization files.

4) The file SCANUAF.HLP is a help file that you can insert in one of 
   your help libraries, if so desired.  If you do so, then it can be
   accessed via the command $ HELP SCANUAF from DCL and also via the
   command SCANUAF> HELP from within SCANUAF.  If you do not enter this
   module in any of your help libraries, then no help will be available
   from within SCANUAF.

5) Copy either SCANUAF.EXE_VAX or SCANUAF.EXE_AXP (whichever is appropriate
   for your hardware platform) to anywhere you want as SCANUAF.EXE.
   Typically, you would copy it to SYS$SYSTEM (or SYS$COMMON:[SYSEXE] in a 
   cluster environment), but that is not required.  Note that the user guide 
   assumes that SCANUAF.EXE is in SYS$SYSTEM.

6) SCANUAF.NODES must be copied to SYS$SYSTEM (or SYS$COMMON:[SYSEXE]), 
   because SCANUAF opens the file as 'SYS$SYSTEM:SCANUAF.NODES'.
   If, for some reason, you do not wish to do this, then you can
   put SCANUAF.NODES wherever you want, modify the source code to
   reflect this, and then rebuild the executable.  You could also
   define a logical name to point to SCANUAF.NODES and modify the
   source to open the file via the logical name specification.
   Note that the user guide assumes that SCANUAF.NODES is in SYS$SYSTEM.

That's it.  I tried to make SCANUAF as as simple as possible to install
and use (no logical names to define, no startup procedure to modify,
no images to install).  If you have problems, you can e-mail me at the
above address until 28-JAN-1994, after which I will no longer be at
Princeton Plasma Physics Laboratory.  I did a bit of a rush job to get
SCANUAF updated before leaving PPPL, so hopefully I didn't introduce 
any new bugs.  Enjoy!