NAME

     bsp_abort - stop a BSP computation

C SYNOPSIS

     #include "bsp.h"

     void bsp_abort(char *format,...);

FORTRAN SYNOPSIS

     SUBROUTINE bspabort(err_string)
     CHARACTER(*), intent(IN)::err_string

DESCRIPTION

     The function bsp_abort can be used to print an error message
     followed by a halt of the entire bsplib(3) program. The rou-
     tine is designed not to require a barrier synchronisation of
     all  processes.  A  single  process  in a potentially unique
     thread of control can therefore halt  the  entire  bsplib(3)
     program.

     In the C version of the function, format is a C-style format
     string  as used by printf(3). Any other arguments are inter-
     preted in the same way as the variable number  of  arguments
     to printf(3).

     err_string is single error string that is printed  when  the
     Fortran  routine is executed. All computation ceases after a
     call to bsp_abort.

SEE ALSO

     bsplib(3)

     ``BSPlib: The BSP Programming Library'' Jonathan M. D. Hill,
     Bill  McColl,  Dan  C.  Stefanescu,  Mark W. Goudreau, Kevin
     Lang, Satish B. Rao, , Torsten Suel, Thanasis Tsantilas, and
     Rob  Bisseling.  Parallel  Computing,  to  appear  1998. See
     http://www.bsp-worldwide.org for more details.

NOTES

     i    If more than one process calls bsp_abort  in  the  same
          superstep,  then  either  one,  all, or a subset of the
          processes that called bsp_abort may print their  format
          string  to the terminal before stopping the BSPlib com-
          putation.

BUGS

     Problems  and  bug  reports  should  be  mailed  to  bsplib-
     bugs@comlab.ox.ac.uk

AUTHORS

     The Oxford BSP Toolset implementation of BSPlib was  written
     by Jonathan.Hill@comlab.ox.ac.uk
     http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html