Zmienne środowiskowe OpenMP

Udostępnia linki do zmiennych środowiskowych używanych w interfejsie API openMP.

Implementacja języka Visual C++ standardu OpenMP obejmuje następujące zmienne środowiskowe. Te zmienne środowiskowe są odczytywane podczas uruchamiania programu i modyfikacje ich wartości są ignorowane w czasie wykonywania (na przykład przy użyciu _putenv, _wputenv).

Zmienna środowiskowa opis
OMP_SCHEDULE Modyfikuje zachowanie klauzuli harmonogramu, gdy schedule(runtime) jest określona for w dyrektywie lubparallel for.
OMP_NUM_THREADS Ustawia maksymalną liczbę wątków w regionie równoległym, chyba że zostanie zastąpiona przez omp_set_num_threads lub num_threads.
OMP_DYNAMIC Określa, czy czas wykonywania OpenMP może dostosować liczbę wątków w regionie równoległym.
OMP_NESTED Określa, czy zagnieżdżona równoległość jest włączona, chyba że zagnieżdżona równoległość jest włączona lub wyłączona z funkcją omp_set_nested.

OMP_DYNAMIC

Określa, czy czas wykonywania OpenMP może dostosować liczbę wątków w regionie równoległym.

set OMP_DYNAMIC[=TRUE | =FALSE]

Uwagi

Zmienna OMP_DYNAMIC środowiskowa może zostać zastąpiona przez funkcję omp_set_dynamic .

Wartość domyślna w implementacji języka Visual C++ standardu OpenMP to OMP_DYNAMIC=FALSE.

Aby uzyskać więcej informacji, zobacz 4.3 OMP_DYNAMIC.

Przykład

Następujące polecenie ustawia zmienną środowiskową OMP_DYNAMIC na wartość TRUE:

set OMP_DYNAMIC=TRUE

Następujące polecenie wyświetla bieżące ustawienie zmiennej środowiskowej OMP_DYNAMIC :

set OMP_DYNAMIC

OMP_NESTED

Określa, czy zagnieżdżona równoległość jest włączona, chyba że zagnieżdżona równoległość jest włączona lub wyłączona z funkcją omp_set_nested.

set OMP_NESTED[=TRUE | =FALSE]

Uwagi

Zmienna OMP_NESTED środowiskowa może zostać zastąpiona przez funkcję omp_set_nested .

Wartość domyślna w implementacji języka Visual C++ standardu OpenMP to OMP_NESTED=FALSE.

Aby uzyskać więcej informacji, zobacz 4.4 OMP_NESTED.

Przykład

Następujące polecenie ustawia zmienną środowiskową OMP_NESTED na wartość TRUE:

set OMP_NESTED=TRUE

Następujące polecenie wyświetla bieżące ustawienie zmiennej środowiskowej OMP_NESTED :

set OMP_NESTED

OMP_NUM_THREADS

Ustawia maksymalną liczbę wątków w regionie równoległym, chyba że zostanie zastąpiona przez omp_set_num_threads lub num_threads.

set OMP_NUM_THREADS[=num]

Parametry

Num
Maksymalna liczba wątków, które mają być w regionie równoległym, do 64 we implementacji języka Visual C++.

Uwagi

Zmienna OMP_NUM_THREADS środowiskowa może zostać zastąpiona przez funkcję omp_set_num_threads lub przez num_threads.

Wartość domyślna num w implementacji standardu OpenMP języka Visual C++ to liczba procesorów wirtualnych, w tym procesorów wielowątkowych.

Aby uzyskać więcej informacji, zobacz 4.2 OMP_NUM_THREADS.

Przykład

Następujące polecenie ustawia zmienną OMP_NUM_THREADS środowiskową na wartość 16:

set OMP_NUM_THREADS=16

Następujące polecenie wyświetla bieżące ustawienie zmiennej środowiskowej OMP_NUM_THREADS :

set OMP_NUM_THREADS

OMP_SCHEDULE

Modyfikuje zachowanie klauzuli harmonogramu, gdy schedule(runtime) jest określona for w dyrektywie lubparallel for.

set OMP_SCHEDULE[=type[,size]]

Parametry

rozmiar
(Opcjonalnie) Określa rozmiar iteracji. rozmiar musi być dodatnią liczbą całkowitą. Wartość domyślna to 1, z wyjątkiem sytuacji, gdy typ jest statyczny. Nieprawidłowy, gdy typ to runtime.

type
Rodzaj planowania, dynamicalbo , guided, runtimelub static.

Uwagi

Wartość domyślna w implementacji języka Visual C++ standardu OpenMP to OMP_SCHEDULE=static,0.

Aby uzyskać więcej informacji, zobacz 4.1 OMP_SCHEDULE.

Przykład

Następujące polecenie ustawia zmienną OMP_SCHEDULE środowiskową:

set OMP_SCHEDULE="guided,2"

Następujące polecenie wyświetla bieżące ustawienie zmiennej środowiskowej OMP_SCHEDULE :

set OMP_SCHEDULE