This is an example of use of the fine PacketSize script.

Notations :
 [@]  : Means that  the file may have to  be adapted for your specific
system (read file content for details)

--------------------

Initial files :
 o al_test.c  : contains the   full example (a  ring-send  of a single
linked list with modification of the packet size)
 o struct.h : contains the script to run
 o Makefile [@] : how to build "ALtest" program 

--------------------

(Steps followed to  get all the files  in this directory (you may want
to re-run them to have a system specific files))

1) Run AutoMap (v2.20) on the "struct.h" file, using command line :
	AutoMap struct.h
   to create the 4 following files :
	mpitypes.inc mpitypes.h al_routines.inc autolink.h

2)  Check the  "Makefile" file  from  AutoLink (v2.20) release in this
directory to adapt its path. This is required by the following entries
:
	al_bench.pl[@] al_packettune.pl[@] runbench[@]
	al_common.h al_internals.c al_internals.h al_routines.inc

(Remaining steps are to run the fine PacketSize tuning script)

3) Run the makefiles commands :
	make
   to get the   "ALtest" file (in   case of error  during compilation,
please check the MPI compilation command line in the Makefile)

4 [Optional]) Check that the MPI program  works the way it is supposed
to, if "mpirun" is the  command to run MPI  progams, followed by  "-np
numberprocessors" and "programname" (then "programoptions"), try :
	mpirun -np 2 ALtest -v -size 1000 -inc 1000
  where the options for the test program are :
-----
Usage : ALtest [-help] [-v] [-size size] [-inc inc] [-min min] [-max max]
 -v : verbose mode
 -size : specify the number of element of the Linked List [default : 10000]
 -inc : specify the increment in the Packet Size (from "min" to "max" by "inc" steps) [default : 1000]
 -min : set the minimal Packet Size [default : 0]
 -max : set the maxinal Packet Size [default : 200020]
-----

5)  Adapt file "runbench"  to suite your  needs and use (run "runbench
-help" for a small help on how to adjust the settings).
5a) Should you want to execute a full run (execution and analyze), type :
	runbench -verb
5b) Should you want to run only the run files creation, type :
	runbench -verb -phase1
5c) Should you want to analyze the run files extracted files, type :
	runbench -verb -phase2

6)  Use the created  output to  choose the   best PacketSize  for your
specific use.
