Edit

MPI_Intercomm_merge function

  • Article

Creates an intracommuncator from an intercommunicator.

Syntax

int MPIAPI MPI_Intercomm_merge(
        MPI_Comm intercomm,
        int      high,
  _Out_ MPI_Comm *newintracomm
);

Parameters

  • intercomm
    Intercommunicator.

  • high
    Used to order the groups within comm when creating the new communicator. This is a boolean value; the group that sets high true has its processes ordered after the group that sets this value to false. If all processes in the intercommunicator provide the same value, the choice of which group is ordered first is arbitrary.

  • newintracomm [out]
    Created intracommunicator.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_INTERCOMM_MERGE(INTERCOMM, HIGH, NEWINTRACOMM, IERROR)
        INTEGER INTERCOMM, NEWINTRACOMM, IERROR
        LOGICAL HIGH

Requirements

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities

Header

 Mpi.h; Mpif.h

Library

 Msmpi.lib

DLL

 Msmpi.dll

See also

MPI Communicator Functions