NAME

       shmem_global_exit - A routine that allows any PE to force termination of an entire program.

SYNOPSIS

       C or C++:
       #include <mpp/shmem.h>
       void shmem_global_exit(int status);

       Fortran:
       include 'mpp/shmem.fh'
       INTEGER STATUS
       CALL SHMEM_GLOBAL_EXIT(status)

DESCRIPTION

       shmem_global_exit()  shmem_global_exit  is  a  non-collective  routine  that  allows  any one PE to force
       termination of an Open- SHMEM program for all PEs, passing an exit status to the  execution  environment.
       This  routine  terminates  the  entire  program,  not  just  the  OpenSHMEM  portion.  When  any PE calls
       shmem_global_exit, it results in the immediate notification to all PEs  to  terminate.  shmem_global_exit
       flushes  I/O  and  releases  resources  in accordance with C/C++/Fortran language requirements for normal
       program termination. If more than one PE calls shmem_global_exit, then the exit status  returned  to  the
       environment  shall  be  one of the values passed to shmem_global_exit as the status argument. There is no
       return to the caller of shmem_global_exit;  control  is  returned  from  the  OpenSHMEM  program  to  the
       execution environment for all PEs.

SEE ALSO

       intro_shmem(3), shmem_my_pe(3), shmem_init(3)