ホスト変数の使用法

ホスト変数は次の場合に使用できます。

SELECT、INSERT、UPDATE、DELETE 文で数値定数または文字列定数を書ける場所。
SELECT、FETCH 文の INTO 句。
ホスト変数は、文名、カーソル名、Embedded SQL 固有の文のオプション名としても使用できます。
CONNECT、DISCONNECT、SET CONNECT 文では、ホスト変数はサーバー名、データベース名、接続名、ユーザー ID、パスワード、接続文字列として使用できます。
SET OPTION と GET OPTION では、オプション値の代わりにホスト変数を使用できます。

ホスト変数は次の場合には使用できません。

ホスト変数は、どの文でもテーブル名、カラム名としては使用できません。
バッチではホスト変数を使用できません。
SET 文のサブクエリ内ではホスト変数を使用できません。

SQLCODE および SQLSTATE ホスト変数

ISO/ANSI 標準を使用することで、Embedded SQL ソースファイルの Embedded SQL 宣言セクション内で次の特別なホスト変数を宣言できます。

long SQLCODE;
char SQLSTATE[6];

使用する場合、これらの変数が設定されるのは、データベース要求を生成する任意の Embedded SQL 文 (DECLARE SECTION、INCLUDE、WHENEVER SQLCODE などを除く EXEC SQL 文) の後になります。したがって、SQLCODE および SQLSTATE ホスト変数は、データベース要求を生成するすべての Embedded SQL 文のスコープで参照可能である必要があります。

次に示すのは、有効な ESQL です。

EXEC SQL INCLUDE SQLCA;
// declare SQLCODE with global scope
EXEC SQL BEGIN DECLARE SECTION;
long SQLCODE;
EXEC SQL END DECLARE SECTION;
sub1() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL CREATE TABLE ...
}
sub2() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL DROP TABLE ...
}

次の例は、SQLSTATE が関数 sub2 のスコープ内で定義されていないため、有効な Embedded SQL ではありません。

EXEC SQL INCLUDE SQLCA;
sub1() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL CREATE TABLE...
}
sub2() {
 exec SQL DROP TABLE...
}

SQL プリプロセッサーの -k オプションでは、Embedded SQL 宣言セクションのスコープの範囲外で SQLCODE 変数を宣言できます。

参照

DocCommentXchange で意見交換できます