IBM Books

管理およびプログラミングの手引き


UDF 戻りコードの処理

組み込み SQL ステートメントは、SQLCA 構造体の SQLCODE、 SQLWARN、 および SQLSTATE フィールドにコードを戻します。 この構造体は SQLCA INCLUDE ファイルの中で定義されます。 (SQLCA 構造体および SQLCA INCLUDE ファイルについて、 詳しくは、DB2 アプリケーション開発の手引き を参照してください。)

DB2 CLI 呼び出しによって SQLCODE 値および SQLSTATE 値が戻ります。 これらは SQLError 関数を使って検索できます。 (SQLError 関数を使ったエラー情報の検索について、 詳しくは、CLI ガイドおよび解説書 を参照してください。)

SQLCODE 値が 0 であれば、ステートメントが正常に実行されたことを意味します (ただし、 警告状態が発生している場合もあります)。 正の SQLCODE 値は、ステートメントが正常に実行されたものの、警告が発生したことを意味します。 (組み込み SQL ステートメントは、 0 または正の SQLCODE 値に関連する警告情報を SQLWARN フィールドに戻します)。 負の SQLCODE 値は、エラーが生じたことを意味します。

DB2 は、それぞれの SQLCODE 値にメッセージを関連付けます。 XML エクステンダー UDF は、警告またはエラーの状態を発見すると、 SQLCODE メッセージに含める関連情報を DB2 に渡します。

SQLSTATE 値には、SQLCODE メッセージを補足するコードが含まれています。 XML エクステンダーが戻すそれぞれの SQLSTATE コードの説明は、 SQLSTATE コードを参照してください。

DB2 XML エクステンダー UDF を呼び出す組み込み SQL ステートメントおよび DB2 CLI 呼び出しによって、 これらの UDF に固有の SQLCODE メッセージや SQLSTATE 値が戻ることもありますが、 DB2 は、他の組み込み SQL ステートメント または DB2 CLI 呼び出しの際と同じようにしてこれらの値を戻します。 したがって、これらの値にアクセスする方法は、 DB2 XML エクステンダー UDF を開始しない組み込み SQL ステートメントまたは DB2 CLI 呼び出しの場合と同じです。

XML エクステンダーが戻す SQLSTATE 値および関連メッセージのメッセージ番号については、 SQLSTATE コードを参照してください。 それぞれのメッセージについては、メッセージを参照してください。


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]