Rocket® Enterprise Developer (formerly a product of Micro Focus or formerly a product of Open Text) documentation, created before Rocket Software acquired certain products from OpenText, may include outdated references to "Micro Focus" or "OpenText", both of which are trademarks of OpenText or its affiliates. Rocket Software is not affiliated with Micro Focus or OpenText and has since rebranded these products as Rocket® products. You may also encounter outdated links in this documentation. If you do, please contact Rocket Support (support@rocketsoftware.com) for assistance.
SQLCA の使用
SQLCA 構造体は、デフォルトでは %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\cpylib(Windows) または $COBDIR/cpylib(UNIX) にある 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 は、ホスト変数として宣言する必要はありません。