SQLCA (SQL 通信域)

SQLCA は一組の変数で、各 SQL ステートメントの実行の終了時に更新されることがあります。実行可能 SQL ステートメントを含むプログラムは、SQLCA を 1 つ提供することはできますが、複数提供することはできません (代わりに独立型 SQLCODE または独立型 SQLSTATE 変数を使用する場合を除く)。ただし、Java™では SQLCA は適用されません。

SQLCA を使用する代わりに、すべての言語で GET DIAGNOSTICS ステートメントを使用して、戻りコードおよび直前の SQL ステートメントに関する他の情報を戻すことができます。詳細については、 GET DIAGNOSTICSを参照のこと。

SQL INCLUDE ステートメントを使用すると、Java、RPG、または REXX を除くすべてのホスト言語で SQLCA の宣言を行うことができます。 REXX プロシージャーでの SQLCA の使用については、「組み込み SQL プログラミング」トピック集を参照してください。 Java のエラーおよび警告に関する情報にアクセスする方法については、「 IBM® Developer Kit for Java 」トピック・コレクションを参照してください。

C、COBOL、および PL/I では、このストレージ域の名前は SQLCA でなければなりません。すべての SQL ステートメントは、必ず SQLCA の宣言の有効範囲内になければなりません。

プログラムで独立型の SQLCODE または SQLSTATE を指定している場合は、SQLCA を組み込んではなりません。詳細は SQL診断情報を参照。

独立型 SQLCODE および独立型 SQLSTATE は、Java または REXX 言語で指定してはなりません。