3.7.13 omp_set_device_teams_thread_limit – Set upper thread limit of a device

Description:

Sets the value of the teams-thread-limit-var ICV for the specified device number, which specifies the upper bound for number of teams created by a teams construct on the device specified by the device_num argument. The thread_limit argument shall be positive integer. If the device_num argument denotes the host device, the routine is identical to the omp_set_teams_thread_limit routine. The device_num argument must be a conforming device number other than omp_invalid_device, else error termination is performed. Invoking this routine on a non-host device has unspecified behavior.

C/C++:
Prototype:void omp_set_device_teams_thread_limit(int thread_limit, device_num)
Fortran:
Interface:subroutine omp_set_device_teams_thread_limit(thread_limit, device_num)
integer, intent(in) :: thread_limit, device_num
See also:

omp_get_device_teams_thread_limit – Get upper thread limit of a device, omp_set_teams_thread_limit – Set upper thread limit for teams construct, omp_get_teams_thread_limit – Maximum number of threads imposed by teams, omp_get_thread_limit – Maximum number of threads, omp_get_supported_threads_dim – Get upper limit of threads in a dimension, OMP_TEAMS_THREAD_LIMIT – Set the maximum number of threads imposed by teams, OMP_THREAD_LIMIT – Set the maximum number of threads

Reference:

OpenMP specification v6.0, Section 24.14