omp_set_max_active_levels

Purpose

Sets the value of the max-active-levels-var internal control variable to the value in the argument. If the number of parallel levels requested exceeds the number of the supported level of parallelism, the value of max-active-levels-var is set to the number of parallel levels supported by the runtime. If the number of parallel levels requested is not a positive integer, this routine call is ignored. When the nested parallelism is turned off, this routine has no effects and the value of max-active-levels-var remains 1. max-active-levels-var can also be set with the OMP_MAX_ACTIVE_LEVELS environment variable. To retrieve the value for max-active-levels-var, use the omp_get_max_active_levels function.

Prototype

void omp_set_max_active_levels(int max_levels);