Region Control

The Intel® MPI Library also supports an optional region feature. The region is an IPM statistics format feature. See IPM Statistics Format for more details about IPM. This feature requires the source code modification. The MPI_Pcontrol function can be used.

Region is a named part of the source code marked by the start/end points through the standard MPI_Pcontrol function calls. The MPI_Pcontrol function isn’t used for the following special permanent regions:

If named regions are not used, the main regions and the complementary regions are identical and the complementary region is ignored.

Each region contains its own independent statistics information about MPI functions called inside the region.

The Intel® MPI Library supports the following types of regions:

A region is opened by the MPI_Pcontrol(1, <name>) call and closed by the MPI_Pcontrol(-1, <name>) call where <name> is a zero terminated string with the region name. The <name> is used in output for IPM statistics format. The default output file for the region is stats_<name>.txt for native statistics format.

All open regions are closed automatically inside the MPI_Finalize environment variable.