SQLCA (SQL 連絡域)

0

正常に実行された (1 つ以上の SQLWARN 標識が設定される場合があります)。

正の値

正常に実行されたが、警告状態である。

負の値

エラー状態。

このフィールドは、正常に接続が完了した場合にも使用されます。

NOT ATOMIC コンパウンド SQL ステートメントが発行されると、7 つ以下のエラーに関する情報を入れることができます。

最後のトークンの後に X'FF' が続くことがあります。 sqlerrml の値には、後続の X'FF' が含まれます。

以下の例では、製品シグニチャーと SQLERRP フィールドの新規トークンとの関係を示しています。 モディフィケーション・パックのどの後続フィックスパックでも、同じ SQLERRP 値が戻されます。

Product           SQLERRP
signature         token
Db2 10.5.0.7      SQL10057
Db2 11.0.0.0      SQL11010
Db2 11.1.1.1      SQL11011
Db2 11.1.2.0      SQL11012

製品のシグニチャー・フォーマットの詳細については、モディフィケーションパックを参照してください。

SQL プロシージャーから正常に戻された場合、その SQL プロシージャーからの戻り状況値が入ります。

接続が正常に起動された場合、 データベースのコード・ページからアプリケーションのコード・ページに変換する際に予想される 混合文字データ (CHAR データ・タイプ) の長さの差の最大値が入ります。 0 または 1 の値は、長さが変わらないことを示し、1 より大きい値は長さが長くなることを、 負の値は切り捨てが生じることを示します。 SQLCA がエラーの発生した NOT ATOMIC コンパウンド SQL ステートメントの結果である場合、 この値はエラーの発生したステートメントの番号に設定されます。

OPEN ステートメントが呼び出され、カーソルに SQL データ変更ステートメントが入っている場合、 このフィールドには、組み込まれた挿入、更新、削除、 またはマージ操作のために修飾された行の合計が入ります。

SQL ルーチン、トリガー、または動的コンパウンド SQL (インライン化またはコンパイル済み) ステートメントのコンパイル中にエラーが発生した場合、sqlerrd(3) には、エラーが発生した行番号が含まれます。 有効な行番号を表すために、この項目の sqlcaid の 6 バイト目は必ず L になります。

コンパイル済み SQL ルーチン、トリガー、または動的 SQL (コンパイル済み) ステートメントの実行中にエラーが発生した場合、sqlerrd(3) には、エラーが発生した行番号が含まれます。 有効な行番号を表すために、sqlcaid の 6 バイト目は必ず M になります。

PREPARE が正常に呼び出された場合、ステートメントを処理するのに必要なリソースの 相対コスト見積もりが入ります。 コンパウンド SQL を呼び出した場合は、 正常に実行されたサブステートメントの数のカウントが入ります。 CONNECT を呼び出した場合は、 最新レベルにないクライアントからの 1 フェーズ・コミットなら 0、 1 フェーズ・コミットなら 1、1 フェーズの読み取り専用コミットなら 2、 2 フェーズ・コミットなら 3 が入ります。

コンパイル済み SQL ルーチンまたはトリガーの実行中にエラーが発生した場合、sqlerrd(4) には、エラーが発生したルーチンまたはトリガーを一意的に識別する整数が含まれます。 有効な行番号を表すために、この項目の sqlcaid の 6 バイト目は必ず M になります。

CONNECT が呼び出され、正常に実行された場合に、データベースが静止状態であれば D が入り、インスタンスが静止状態であれば I が入ります。

^a 一部の関数では、NULL 値が除去されても SQLWARN2 が W にならないことがあります。 これは、結果が NULL 値の除去によるものでない場合に生じます。