結果セットを受け取る Db2 ODBC クライアント・アプリケーションのプログラミング
クライアント・アプリケーションからストアード・プロシージャーを実行した後、 そのストアード・プロシージャーから結果セットを受け取ります。これらの結果セットは、 照会から結果セットを受け取るのと同じ方法で受け取ることができます。
手順
結果セットをストアード・プロシージャーから受け取る Db2® ODBC クライアント・アプリケーションを作成するには、以下のようにします。
- オープン・カーソルが、CALL SQL ステートメントを出す予定のステートメント・ハンドルと 必ず関連付けられていないようにします。
- SQLPrepare() と SQLExecute() を呼び出すか、SQLExecDirect() を呼び出して、起動させるストアード・プロシージャーの CALL SQL ステートメントを実行します。 このように CALL SQL ステートメント を実行することにより、結果セットに関連付けられたカーソルが効率的にオープンされます。
- ストアード・プロシージャーが戻す出力パラメーターを調べます。 例えば、プロシージャーは、生成された結果セットの数を 正確に示す出力パラメーターを持つように設計されている場合があります。 そのような場合は、この情報を使用すればより効率的に結果セットを受け取ることができます。
- 結果セットの性質、あるいは結果セットに含まれる列数がわからない場合は、SQLNumResultCols()、SQLDescribeCol()、または SQLColAttribute() を呼び出します。
- 結果セットは順次に処理する必要があります。 ストアード・プロシージャーが対応するカーソルをオープンする順に、一度に 1 つずつ、 各結果セットを受け取ります。
- SQLBindCol()、SQLFetch()、および SQLGetData() の許可される組み合わせを使用して、現行カーソルからデータ・セットを取得します。 現行の結果セットの処理が終了した場合には、SQLMoreResults() を 呼び出して、受け取る結果セットがまだあるかどうかをチェックしてください。 まだ結果セットがある場合は、SQLMoreResults() は、SQL_SUCCESS を戻し、現行カーソルをクローズして、次のオープン・カーソルへ処理を進めます。もう残っていない場合は、SQLMoreResults() は SQL_NO_DATA_FOUND を戻します。 ストアード・プロシージャーが戻す結果セットをすべて受け取るまで、 ステップ 3 からステップ 6 までを 繰り返します。