JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Studio 12.3: OpenMP API User's Guide     Oracle Solaris Studio 12.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  Introducing the OpenMP API

2.  Compiling and Running OpenMP Programs

3.  Implementation-Defined Behaviors

3.1 Task Scheduling Points

3.2 Memory Model

3.3 Internal Control Variables

3.4 Dynamic Adjustment of Threads

3.5 Loop Directive

3.6 Constructs

3.6.1 SECTIONS

3.6.2 SINGLE

3.6.3 ATOMIC

3.7 Routines

3.7.1 omp_set_num_threads()

3.7.2 omp_set_schedule()

3.7.3 omp_set_max_active_levels()

3.7.4 omp_get_max_active_levels()

3.8 Environment Variables

3.9 Fortran Issues

3.9.1 THREADPRIVATE Directive

3.9.2 SHARED Clause

3.9.3 Runtime Library Definitions

4.  Nested Parallelism

5.  Tasking

6.  Automatic Scoping of Variables

7.  Scope Checking

8.  Performance Considerations

A.  Placement of Clauses on Directives

Index

3.8 Environment Variables

Variable Name
Implementation
OMP_SCHEDULE
If the schedule type specified for the OMP_SCHEDULE is not one of the valid types (static, dynamic, guided, or auto), then the environment variable is ignored, and the default schedule (static with no chunk size) is used. A warning message is issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().

If the schedule type specified for the OMP_SCHEDULE environment variable is static, dynamic, or guided but the chunk-specified size is a negative integer, then the chunk size used is as follows: For static, there is no chunk size . For dynamic and guided, the chunk size is 1. A warning message is issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().

OMP_NUM_THREADS
If the value of the variable is not a positive integer, then the environment variable is ignored and a warning message issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().

If the value of the variable is greater than the number of threads the implementation can support, the following actions are taken:

  • If dynamic adjustment of the number of threads is enabled, then the number of threads will be reduced and a warning message will be issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().

  • If dynamic adjustment of the number of threads is disabled, then an error message will be issued and the program will stop.

OMP_PROC_BIND
If the value specified for OMP_PROC_BIND is neither TRUE nor FALSE, then an error message will be issued and the program will stop.
OMP_DYNAMIC
If the value specified for OMP_DYNAMIC is neither TRUE nor FALSE, then the value will be ignored, and the default value TRUE will be used. A warning message will be issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().
OMP_NESTED
If the value specified for OMP_NESTED is neither TRUE nor FALSE, then the value will be ignored and the default value FALSE will be used. A warning message will be issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().
OMP_STACKSIZE
If the value given for OMP_STACKSIZE does not conform to the specified format, then the value will be ignored and the default value (4 Megabytes for 32-bit applications, and 8 Megabytes for 64-bit applications) is used. A warning message is issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().
OMP_WAIT_POLICY
The ACTIVE behavior for a thread is spin. The PASSIVE behavior for a thread is sleep, after possibly spinning for a while.
OMP_MAX_ACTIVE_LEVELS
If the value specified for OMP_MAX_ACTIVE_LEVELS is not a nonnegative integer, then the value will be ignored and the default value (4) will be used. A warning message will be issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().
OMP_THREAD_LIMIT
If the value specified for OMP_THREAD_LIMIT is not a positive integer, then the value will be ignored and the default value (1024) will be used. A warning message will be issued if SUNW_MP_WARN is set to TRUE or a callback function is registered by a call to sunw_mp_register_warn().