MPI_START, MPI_Start

Purpose

Activates a persistent request operation.

C synopsis

#include <mpi.h>
int MPI_Start(MPI_Request *request);

C++ synopsis

#include mpi.h
void MPI::Prequest::Start();

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_START(INTEGER REQUEST,INTEGER IERROR)

Parameters

request
     is a communication request (handle) (INOUT)

IERROR
     is the FORTRAN return code. It is always the last argument.

Description

MPI_START activates a persistent request operation. A communication started
with MPI_START is completed by a call to one of the MPI wait or test
operations. request is a handle returned by MPI_RECV_INIT, MPI_RSEND_INIT,
MPI_SSEND_INIT, MPI_BSEND_INIT or MPI_SEND_INIT. Once the call is made, do
not access the communication buffer until the operation completes.

If the request is for a send with ready mode, then a matching receive must
be posted before the call is made. If the request is for a buffered send,
adequate buffer space must be available.

Errors

Invalid request

Request not persistent

Request already active

Insufficient buffer space
     only if buffered send

MPI not initialized

MPI already finalized

Related information

     MPI_BSEND_INIT
     MPI_RECV_INIT
     MPI_RSEND_INIT
     MPI_SEND_INIT
     MPI_SSEND_INIT