6.14.1　WHENEVERの形式と規則

(1)　機能

SQLの実行後，HiRDBがSQL連絡領域に設定したリターンコード（SQLCODE）によって，UAPの処理を宣言します。

ページの先頭へ

(2)　形式

　WHENEVER
　　｛SQLERROR｜SQLWARNING｜NOT FOUND｝
　　｛CONTINUE｜｛GO TO｜GOTO｝〔：〕ホスト識別子
　　　　　　　　｜〔DO〕PERFORM〔：〕ホスト識別子
　　　　　　　　｜DO ｛break｜continue｜'命令文'｝｝

ページの先頭へ

(3)　オペランド

ページの先頭へ

(4)　共通規則

1. 埋込み例外宣言を指定しないと，すべてのリターンコードに対してCONTINUEが仮定されます。

2. 埋込み例外宣言は，同じUAP中に複数個指定できます。

3. SQLERRORの状態で，ROLLBACK文以外のSQLは実行できません。

4. 手続き実行後の制御は，特異状態が発生したSQLの次の命令へ戻ります。

5. 埋込み例外宣言で指定した処理の有効範囲は，ソースプログラム上の位置によって決まります。すなわち，ある一つの埋込み例外宣言で指定された処理は，ソースプログラム上の次の同じ特異状態の処理を指定した埋込み例外宣言までの間にあるすべてのSQLの実行結果で有効になります。

   埋込み例外宣言で指定した処理の有効範囲を，次の図に示します。

   図6‒1　埋込み例外宣言で指定した処理の有効範囲

6. SQLERROR，SQLWARNING，NOT FOUNDの有効範囲が重複した場合は，次に示す優先順位でSQLが処理されます。

   SQLERROR→NOT FOUND→SQLWARNING

ページの先頭へ

(5)　留意事項

1. WHENEVER文で宣言した処置が途中のSQLから不要になる場合，同じ特異状態（SQLERRORなど）に対する処置として，CONTINUE（処理を続行する）を指定したWHENEVER文を，不要にする位置に記述してください。

   WHENEVER文の記述例を，次の図に示します。

   図6‒2　WHENEVER文の記述例（その1）

2. SQLERROR指定のWHENEVER文によって，あるSQLの実行エラーで分岐した先で，ROLLBACK文を実行する場合，無限ループしないように注意してください。

   WHENEVER文の記述例を，次の図に示します。

   図6‒3　WHENEVER文の記述例（その2）

3. 埋込み例外宣言は，UAPの複数の関数にわたって有効です。

   WHENEVER文で指定したGOTO文の分岐先は，SQL文と同じ関数内に指定してください。関数外への分岐先を指定すると，コンパイル時にエラーになります。

   また，必要に応じて，関数ごとにWHENEVER文を宣言し直してください。

   WHENEVER文の記述例を，次の図に示します。

   図6‒4　WHENEVER文の記述例（その3）

   図6‒5　WHENEVER文の記述例（その4）

4. WHENEVER文は，FREE CONNECTION HANDLEの前で宣言しないでください。

ページの先頭へ

(6)　使用例

• 処理P1中のSQLを実行した後，SQLCODEに負の値が返された場合，L1へ分岐します。

• 処理P2中のSQLを実行した後，SQLCODEに負の値が返された場合，IF文を使用して分岐先を決めるため，WHENEVER文による制御を取り消します。

• 処理P3中の表の検索で，検索する行がなくなった場合はL2へ分岐します。

• 処理p3中の表の検索でSQLCODEに負の値が返された場合，break文を実行します。

• 処理p3中の表の検索でユーザに警告する状態を検知した場合，関数を呼び出します。

  

ページの先頭へ