TARGET / END TARGET

構文

           .-+---+-------------.   
           | '-,-'             |   
           V                   |   
>>-TARGET----+---------------+-+-------------------------------><
             '-target_clause-'     

>>-block-------------------------------------------------------><

>>-END TARGET--------------------------------------------------><

target_clause は以下のいずれかです。

>>-+-defaultmap_clause----+------------------------------------><
   +-depend_clause--------+   
   +-device_clause--------+   
   +-firstprivate_clause--+   
   +-if_clause------------+   
   +-is_device_ptr_clause-+   
   +-map_clause-----------+   
   +-nowait_clause--------+   
   '-private_clause-------'   

defaultmap_clause

これは、スカラー変数用にデフォルト暗黙マッピング規則を FIRSTPRIVATE から TOFROM に変更します。 構文は DEFAULTMAP(TOFROM:SCALAR) です。 暗黙マッピングについて詳しくは、「規則」セクションを参照してください。

depend_clause

ターゲット・タスクと、リスト項目を共有する兄弟タスクとの間のスケジューリング依存性を設定します。 構文は DEPEND(dependence-type:list) です。 dependence-type は IN、OUT、INOUT のいずれかです。 list 内のデータ変数はコンマで区切ります。

• dependence-type が IN または INOUT の場合、依存性タイプが OUT または INOUT であるタスクの DEPEND 節にあるリスト項目と同じストレージ・ロケーションのリスト項目ごとに、ターゲット・タスクの兄弟タスクに対するスケジューリング依存性が作成されます。
• dependence-type が OUT または INOUT の場合、依存性タイプが IN、OUT、または INOUT である兄弟タスクの DEPEND 節にあるリスト項目と同じストレージ・ロケーションのリスト項目ごとに、ターゲット・タスクの兄弟タスクに対するスケジューリング依存性が作成されます。

device_clause

指定した ID を持つ装置上にデータ環境を作成します。 構文は DEVICE(scalar-integer-expression) です。 scalar-integer-expression は、omp_get_num_devices 関数の値より小さくて負ではない整数値に評価されなければなりません。

firstprivate_clause

これは、リストされたデータ変数がターゲット・タスク専用であり、領域を実行する各スレッド・チームによって共用されることを宣言します。 ステートメント・ブロック内で暗黙の宣言があるかのように、ターゲット・タスクによって参照されるリスト項目ごとに、新しい項目が作成されます。 新規 private オブジェクトはそれぞれ、元の変数の値を使用して初期化されます。

詳しくは、FIRSTPRIVATEを参照してください。

if_clause

IF 文節が存在し、その IF 文節式が false に評価される場合、ターゲット領域はホスト・データ環境においてホスト・デバイスによって実行されます。 構文は IF([TARGET:]logical-expression) です。

is_device_ptr_clause

リストされたデータ変数が、装置データ環境内に存在する装置ポインターであることを指示します。 リストされたデータ変数はいずれも、仮引数でなければなりません。 構文は IS_DEVICE_PTR(list) です。

map_clause

これは、ホスト・データ環境にある元の変数から、構文で指定されたデバイスのデバイス・データ環境において対応する変数に、リストにあるデータ変数を明示的にマップするように指定します。 構文は MAP([[map-type-modifier[,]]map-type:]list) です。

map-type は、TO、FROM、TOFROM、または ALLOC にすることができます。

• リスト項目が装置データ環境に存在しない場合は、新しい項目が装置データ環境に作成されます。
  • map-type が TO または TOFROM の場合は、この新しい項目が、ホスト・データ環境内の list にある元のリスト項目の値で初期化されます。
  • map-type が FROM または ALLOC の場合、デバイス・データ環境内のリスト項目の初期値は未定義です。
  ターゲット領域の終了時、この構文が最初に検出されたときにリスト項目のストレージが装置データ環境に作成された場合は、リスト項目が装置データ環境から割り振り解除されます。 さらに、map-type が FROM または TOFROM の場合は、デバイス・データ環境内のリスト項目が割り当て解除される前に、元のリスト項目が、デバイス・データ環境内の対応するリスト項目の現行値で更新されます。
• リスト項目が装置データ環境に存在する場合は、構文が検出されると、装置環境内の項目の割り振りカウントが以下のように変更されます。
  • 構文の始まりで 1 ずつ増加されます。
  • 構文の終わりで 1 ずつ減少されます。

map-type-modifier は ALWAYS です。 この修飾子が存在する場合は、以下の規則が適用されます。

• map-type が TO または TOFROM の場合は、元のリスト項目の値が常にデバイス環境にコピーされます。 これは、リスト項目に関してデバイス・データ環境に新規項目が作成されたかどうかには関係なく行われます。
• map-type が FROM または TOFROM の場合は、リスト項目の値が常にデバイス環境から元のリスト項目にコピーされます。 これは、構文の終了時にデバイス・リスト項目が割り当て解除されるかどうかには関係なく行われます。

関連名を map_clause で指定できます。

nowait_clause

ターゲット・タスクがまだ完了していなくても、親タスクを進行できるように、暗黙のバリアを除去します。 デフォルトでは、暗黙のバリアは target 構文の終わりに存在します。 これにより、ターゲット・タスクが完了するまで親タスクは続行できません。 構文は NOWAIT です。

private_clause

これは、リストされたデータ変数がターゲットに専用であり、領域を実行する各スレッド・チームによって共用されることを宣言します。 ターゲット・タスクによって参照されるリスト項目ごとに、新しい項目が作成されます。

詳しくは、PRIVATEを参照してください。

reduction_clause

list 内の各データ変数に関して、プライベート・コピーが作成され、reduction-identifier に基づいて初期化されることを指定します。 領域の終了時に、元のデータ変数は、reduction-identifier に基づいたコンバイナーを使用して、プライベート・コピーの値で更新されます。

構文は REDUCTION(reduction-identifier:list) です。スカラー変数は list でサポートされています。 list 内の項目はコンマで区切ります。 reduction-identifier は、演算子 +、-、*、.and.、.or.、.eqv.、.neqv.、または組み込みプロシージャー名 max、min、iand、ior、ieor のいずれかです。

制限: TARGET ディレクティブの reduction 節は、TARGET PARALLEL DO や TARGET TEAMS DISTRIBUTE PARALLEL DO のような組み合わせ構文の形式でのみサポートされます。

block

これは、デバイス・データ環境で実行されるコード・ブロックを表します。