Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

TEAMS DISTRIBUTE PARALLEL DO

OpenMP* Fortran Compiler Directive: Creates a league of thread teams to execute a structured block in the primary thread of each team. It also specifies a loop that can be executed in parallel by multiple threads that are members of multiple teams.

Syntax

!$OMP TEAMS DISTRIBUTE PARALLEL DO [clause[[,] clause]... ]

   do-loop

[!$OMP END TEAMS DISTRIBUTE PARALLEL DO]

clause

Can be any of the clauses accepted by the TEAMS or DISTRIBUTE PARALLEL DO directives with identical meanings and restrictions.

do-loop

Is one or more DO iterations (DO loops). The DO iteration cannot be a DO WHILE or a DO loop without loop control. The DO loop iteration variable must be of type integer.

All loops associated with the construct must be structured and perfectly nested; that is, there must be no intervening code and no other OpenMP* Fortran directives between any two loops.

The iterations of the DO loop are distributed across the existing team of threads. The values of the loop control parameters of the DO loop associated with a DO directive must be the same for all the threads in the team.

This directive provides a shortcut for specifying a TEAMS construct immediately followed by a DISTRIBUTE PARALLEL DO construct. Some clauses are permitted on both constructs.

If the END TEAMS DISTRIBUTE PARALLEL DO directive is not specified, an END TEAMS DISTRIBUTE PARALLEL DO directive is assumed at the end of do-loop.