C および C++ でのホスト変数および標識変数の宣言
プログラムのSQLステートメントでホスト変数、ホスト変数配列およびホスト構造を使用して、Db2とアプリケーションの間でデータを渡すことができます。
プロシージャー
ホスト変数、ホスト変数配列、およびホスト構造を宣言するには 、
- 以下の規則とガイドラインに従って、変数を宣言します。
- これにより、プログラム内に複数のホスト変数宣言セクションを設けることができます。
- クラス・メンバーをホスト変数として使用できます。 クラス・メンバーをホスト変数として使用する場合、そのクラス・メンバーは、 そのクラス内のどのような SQL ステートメントに対してもアクセス可能となります。 しかし、クラス・オブジェクトはホスト変数として使用できません。
- ONEPASS SQL処理オプションを指定する場合、SQLステートメントで使う前に、各ホスト変数と各ホスト変数配列を明示的に宣言しなければなりません。 TWOPASS プリコンパイラー・オプションを指定する場合は、それぞれのホスト変数を、DECLARE CURSOR ステートメント内で使用する前に宣言する必要があります。制限事項 ： Db2 coprocessorDb2 C/C++は、ONEPASSオプションのみをサポートしています。
- STDSQL（YES）SQL処理オプションを指定する場合、ホスト変数およびホスト変数配列を定義するホスト言語ステートメントの前にBEGIN DECLARE SECTIONステートメントを置き、ホスト言語ステートメントの後にEND DECLARESECTIONステートメントを続けなければなりません。 そうでなければ、これらのステートメントはオプションです。
- ホスト変数またはホスト変数配列を使うSQLステートメントが、その変数または配列を宣言するステートメントのスコープにあるように確保してください。
Db2 precompiler を使用している場合は、変数や変数配列が異なるブロック、クラス、プロシージャ、関数、サブルーチンに存在する場合でも、ホスト変数およびホスト変数配列の名前がプログラム内で一意であることを確認してください。 構造名を修飾して名前を一意にすることができます。