This directory contains HeNCE 2.0 in both source and object form.  HeNCE
is a visual graphical parallel programming environment.  Programmers
draw and then annotate pictures that represent parallel programs.
HeNCE automatically converts them into parallel programs that run on
heterogeneous networks of workstations using the PVM system.

See hence-2.0-doc.ps for a complete description as well as installation and
use intructions.  It also contains a tutorial example on using HeNCE.
It is important that you examine this manual if you plan on trying
HeNCE.  You will not get far without it.

Since HeNCE programs run under PVM, the first thing you must do in
order to use HeNCE is obtain and compile PVM.  We recommend either
version 3.3 or version 3.2.6.  Both are available by anonymous ftp
to ftp.netlib.org.  PVM must be installed in your home directory in
(in ~/pvm3) in order for HeNCE to work.

The easiest way to obtain and try HeNCE is to download one of the
"full" binary packages.  These contains all files (except for PVM)
that you need to run HeNCE on a network of workstations of a given
type.  All programs are already compiled.  If you use more than one
workstation type, get more than one full package.  Send us email if
there are no binaries available for your machine type.  We will
provide them, if we can.  Also, we would really like to know if these
binaries do not work for you for some reason.  This binary
distribution is an experiment for us.  Source is available separately. 

*** NOTICE to SUN 4 users ******

The binary version of HeNCE uses the openwin libraries.  Thus, you
may need to enter "setenv LD_LIBRARY_PATH /usr/openwin/lib" in
order to tell htool where to find libaries.  

Also, Solaris 2.x is not yet supported, due to bugs in Sun's 
implementation of imake on that platform.  With enough effort it
should be possible to make it work, but we need encouragement 
if we are to mess with it.  You may be able to use the SunOS 4.1.3
binary in compatibility mode (see below), but we haven't tried it.

*** NOTICE to users of shells other than csh and tcsh ****

There are some twists to using PVM 3.3 with shells other than
csh and near-clones.  Users of ksh, in particular, should be
sure to read PVM 3.3's release notes.  There is no problem with
PVM 3.2.6.

Contact:

Send questions, bug reports, etc., about HeNCE to hence@cs.utk.edu.

For bug reports, it is essential that you include the version of
HeNCE being used, the version of PVM being used, and the architecture
name of the system that exhibited the bug.

Files:

hence-2.0-src.tar.Z.uu

   All source code for HeNCE.  Requires X11R4 or X11R5 and the Athena
   Widget libraries.  Building will be much simpler if your system
   has a correctly configured imake facility.  See hence-2.0-doc.ps for
   building hints.  We suggest that you try the binaries first, if
   you can.

hence-2.0-doc.ps.Z.uu

  The HeNCE user and installation manual.  You need this.

hence-2.0-examples.tar.Z.uu.

  Some example HeNCE programs.  You will likely want these.