SQLCA の使用

SQLCA 構造体は、デフォルトでは %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\cpylib にある sqlca.cpy ファイルで提供されています。これをプログラムで使用するには、データ部に次の文を記述します。

     EXEC SQL INCLUDE SQLCA END-EXEC

この文を記述しない場合でも、COBOL コンパイラによって自動的に領域が割り当てられますが、プログラムはその領域にはアクセスできません。ただし、SQLCODE または SQLSTATE データ項目を別途宣言すれば、各 EXEC SQL 文の実行後に SQLCA 内の対応フィールドをユーザー定義フィールドにコピーするコードが COBOL コンパイラによって生成されます。

MFSQLMESSAGETEXT データ項目を宣言すると、SQLCODE でゼロ以外の値が検出されるたびに、例外条件の記述によってこのデータ項目が更新されます。MFSQLMESSAGETEXT は、文字データ項目 PIC X(n) として宣言します。n には、任意の有効な値を指定できます。ODBC エラー メッセージは、70 バイトの SQLCA メッセージフィールドを超えることがあるため、MFSQLMESSAGETEXT データ項目は特に有用です。

注: SQLCA、SQLCODE、SQLSTATE、または MFSQLMESSAGETEXT は、ホスト変数として宣言する必要はありません。