MPI Programming Guide

MP_NLIGHTS, mpc_nlights

Purpose

Gets the number of Program Marker Array lights defined for this session.

Library

libmpi.a

C synopsis

#include <mp_marker.h>
int mpc_nlights();

FORTRAN synopsis

MP_NLIGHTS(INTEGER NLIGHT)

Parameters

In FORTRAN, the number of Program Marker Array lights defined for this session is returned in the variable NLIGHT.

Description

This parallel utility subroutine returns the number of Program Marker Array lights defined for this session.

Notes

• You can set the number of Program Marker Array lights by using the environment variable MP_PMLIGHTS or the command line option -pmlights.
• This subroutine is not supported with threads programs.

Return values

In C, the current number of the Program Marker Array lights is the return value.

Examples

C Example

The following program uses poe with the -pmlights 3 option and one task:

#include <mp_marker.h>
 
main()
{
 printf("Number of Program Marker Array lights for this session is %d\n",
 mpc_nlights());
}

Running this C program produces the following output:

• Number of Program Marker Array lights for this session is 3.
  

FORTRAN Example

The following program uses poe with the -pmlights 3 option and one task:

INTEGER LIGHTS
 
CALL MP_NLIGHTS(LIGHTS)
WRITE(6, *) 'Number of Program Marker Array lights for this xsession is ', LIGHTS
END

Running the above produces the following output:

•  Number of Program Marker Array lights for this session is 3.
  

Related information

Commands: pmarray

Subroutines: MP_MARKER, mpc_marker