MPI_Intercomm_merge - Creates an intracommuncator from an
       intercommunicator


SYNOPSIS

       C:

            #include <mpi.h>

            int MPI_Intercomm_merge ( comm, high, comm_out )
            MPI_Comm  comm;
            int       high;
            MPI_Comm *comm_out;

       C++:

            #include <mpi.h>

            Intracomm Intercomm::Merge(
            bool              high) const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            INTEGER intercomm, intracomm, ierror
            LOGICAL high

            CALL MPI_INTERCOMM_MERGE(intercomm, high, intracomm, ierror)


STANDARDS

       This release implements the MPI 1.2 standard, as
       documented by the MPI Forum in the spring 1997 release of
       MPI:  A Message Passing Interface Standard.


DESCRIPTION

       The MPI_Intercomm_merge routine creates an
       intracommuncator from an intercommunicator.  This routine
       accepts the following parameters:

       comm      Specifies  the intercommunicator

       high      Specifies a value used to order the groups of
                 the two intracommunicators within comm when
                 creating the new communicator

       comm_out  Returns the created intracommunicator

       ierror    Specifies the return code value for successful
                 completion, which is in MPI_SUCCESS.
                 MPI_SUCCESS is defined in the mpif.h file.

       The following algorithm is used to create the
       intracommunicator:

       1.     Allocate two contexts.

       2.     Swap high values between local and remote group
              leaders.

       3.     Determine the high value.

       4.     Merge the two groups and make the
              intracommunicator.


Man(1) output converted with man2html