イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

UDF 戻りコードの処理

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

DB2 CLI 呼び出しは SQLCODE 値と SQLSTATE 値を戻します。 これらの値は、SQLError 関数を使用して取り出すことができます。 (SQLError 関数を使ってエラー情報を取り出す方法の詳細は、 コール・レベル・インターフェースの手引きおよび解説書 を参照してください。)

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

DB2 は、メッセージをそれぞれの SQLCODE 値に関連付けます。 DB2 エクステンダー UDF が警告またはエラー状態を検出した場合は、DB2 に関連情報を渡して、この情報が SQLCODE メッセージに含まれるようにします。

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

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

エクステンダーが戻す可能性のある関連メッセージの SQLSTATE 値とメッセージ番号については、SQLSTATE コードを参照してください。 それぞれのメッセージの詳細については、メッセージを参照してください。


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