MPI Subroutine Reference

MPI_COMM_SET_ERRHANDLER, MPI_Comm_set_errhandler

Purpose

Attaches a new error handler to a communicator.

C synopsis

#include <mpi.h>
int MPI_Comm_set_errhandler (MPI_Comm comm, MPI_Errhandler *errhandler);

C++ synopsis

#include mpi.h
void MPI::Comm::Set_errhandler(const MPI::Errhandler& errhandler);

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_COMM_SET_ERRHANDLER(INTEGER COMM, INTEGER ERRHANDLER, INTEGER IERROR)

Parameters

comm

is the communicator (handle) (INOUT)

errhandler

is the new error handler for the communicator (handle) (IN)

IERROR

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

Description

This subroutine attaches a new error handler to a communicator. The error handler must be either a predefined error handler, or an error handler created by a call to MPI_COMM_CREATE_ERRHANDLER. The previously-attached error handler is replaced.

Notes

MPI_COMM_SET_ERRHANDLER supersedes MPI_ERRHANDLER_SET.

For information about a predefined error handler for C++, see IBM Parallel Environment for AIX: MPI Programming Guide.

Errors

Invalid communicator

Invalid error handler

MPI not initialized

MPI already finalized

Related information

MPI_COMM_CALL_ERRHANDLER

MPI_COMM_CREATE_ERRHANDLER

MPI_COMM_GET_ERRHANDLER

MPI_ERRHANDLER_FREE