この節では、DB2 に用意されているサンプル・プログラムについて説明します。すべてのサンプル・プログラムは、 sqllib ディレクトリーの samples サブディレクトリーの中に入っています。サポートされている言語ごとにサブディレクトリーが 1 つずつあります。
本書で使用されるサンプル・プログラムは、サポートされるホスト言語による組み込み SQL ステートメントおよび API 呼び出しの例を示しています。サンプル・プログラムは、短くかつ単純に作られています。プロダクション・アプリケーションは、API 呼び出しおよび SQL ステートメントからの戻りコード、特に SQLCODE または SQLSTATE を調べなければなりません。エラー条件、SQLCODE、および SQLSTATE の処理については、 診断処理と SQLCA 構造を参照してください。これらのプログラムを現在使用している環境で導入、作成、および実行する方法については、 アプリケーション構築の手引き を参照してください。
注:
サンプル・プログラムは、DB2 アプリケーション開発 (DB2 AD) クライアントに付属しています。サンプル・プログラムをテンプレートとして使用して、独自のアプリケーションを作成することができます。
サンプル・プログラムのファイル拡張子は、サポートされる各言語ごとに異なり、各言語内でも、組み込み SQL プログラムと非組み込み SQL プログラムとでは異なります。さらには、各言語内のプログラム・グループごとにも異なっています。これらのサンプル・ファイル拡張子を分類したのが、次の表です。
次の表は、サンプル・プログラムをタイプで分類しています。
注:
言語 | ディレクトリー | 組み込み SQL を含むプログラム | 組み込み SQL を含まないプログラム |
---|---|---|---|
C |
samples/c samples/cli (CLI プログラム) | .sqc | .c |
C++ | samples/cpp |
.sqC (UNIX) .sqx (Windows および OS/2) |
.C (UNIX) .cxx (Windows および OS/2) |
COBOL |
samples/cobol samples/cobol_mf | .sqb | .cbl |
JAVA | samples/java | .sqlj | .java |
REXX | samples/rexx | .cmd | .cmd |
表 39. プログラム・グループ別のサンプル・ファイル拡張子
サンプル・グループ | ディレクトリー | ファイル拡張子 |
---|---|---|
ADO, RDO, MTS |
samples\ADO\VB (Visual Basic) samples\ADO\VC (Visual C++) samples\RDO samples\MTS |
.bas .frm .vbp (Visual Basic) .cpp .dsp .dsw (Visual C++) |
CLP | samples/clp | .db2 |
OLE |
samples\ole\msvb (Visual Basic) samples\ole\msvc (Visual C++) |
.bas .vbp (Visual Basic) .cpp (Visual C++) |
OLE DB | samples\oledb | .db2 |
SQL プロシージャー | samples/sqlproc |
.db2 .c .sqc (クライアント・アプリケーション) |
ユーザー出口 | samples/c |
.cad (OS/2) .cadsm (UNIX および Windows) .cdisk (UNIX および Windows) .ctape (UNIX) |
注: |
|
サンプル・プログラムは、DB2 がインストールされているディレクトリーの samples サブディレクトリーに入っています。サポートされている言語ごとにサブディレクトリーが 1 つずつ作成されます。以下の例では、サポートされている各プラットフォーム用に C または C++ で作成されたサンプルがある場所を探す方法を示しています。
組み込み SQL および DB2 API プログラムの C ソース・コードは、データベース・インスタンス・ディレクトリーの下にある sqllib/samples/c にあります。 DB2 CLI プログラムの C ソース・コードは、 sqllib/samples/cli にあります。サンプル表にあるプログラムの追加情報については、 DB2 インスタンスの下の該当する samples サブディレクトリーの README ファイルを参照してください。 README ファイルには、本書でリストされていない追加のサンプルが含まれることがあります。
組み込み SQL と DB2 API プログラムの C ソース・コードは、 DB2 インストール・ディレクトリーの下にある %DB2PATH%\samples\c にあります。 DB2 CLI プログラムの C ソース・コードは、 %DB2PATH%\samples\cli にあります。変数 %DB2PATH% で、 DB2 のインストール先を判別できます。 DB2 がインストールされているドライブによっては、 %DB2PATH% は drive:\sqllib を指します。サンプル表にあるプログラムの追加情報については、該当する %DB2PATH%\samples サブディレクトリーの README ファイルを参照してください。 README ファイルには、本書でリストされていない追加のサンプルが含まれることがあります。
ご使用のプラットフォームについて表 38 で言及されていなかった場合は、ご使用の環境に固有の情報を、アプリケーション構築の手引き で参照してください。
サンプル・プログラム・ディレクトリーは、たいていのプラットフォームでは一般に読み取り専用です。サンプル・プログラムは、変更または作成する前に、ユーザーの作業ディレクトリーにコピーしてください。