HOME
| OPENMP API Specification: Version 5.0 November 2018

3.2.16  omp_set_max_active_levels

SummaryThe omp_set_max_active_levels routine limits the number of nested active parallel regions on the device, by setting the max-active-levels-var ICV

Format

SVG-Viewer needed.

 

 
void omp_set_max_active_levels(int max_levels);  

SVG-Viewer needed.

SVG-Viewer needed.

 

 
subroutine omp_set_max_active_levels(max_levels) 
integer max_levels  

SVG-Viewer needed.

Constraints on ArgumentsThe value of the argument passed to this routine must evaluate to a non-negative integer, otherwise the behavior of this routine is implementation defined.

BindingWhen called from a sequential part of the program, the binding thread set for an omp_set_max_active_levels region is the encountering thread. When called from within any parallel or teams region, the binding thread set (and binding region, if required) for the omp_set_max_active_levels region is implementation defined.

EffectThe effect of this routine is to set the value of the max-active-levels-var ICV to the value specified in the argument. If the number of active levels requested exceeds the number of active levels of parallelism supported by the implementation, the value of the max-active-levels-var ICV will be set to the number of active levels supported by the implementation.

This routine has the described effect only when called from a sequential part of the program. When called from within a parallel or teams region, the effect of this routine is implementation defined.

Cross References