この章では、Pervasive Distributed Tuning Objects を構成する機能について説明します。

Distributed Tuning Objects（以降、このマニュアルでは DTO と表記します）は、Pervasive Distributed Tuning Interface（以降、このマニュアルでは DTI と表記します）の COM ラッパーです。DTO は DTI をカプセル化するオブジェクトのコレクションです。また、DTO にはデータベース エンジンの起動および停止など DTI よりも優れた機能がいくつかあります。

DTO を使用すれば、開発者はカスタマイズされたサーバー管理ツールやインターフェイスを多岐にわたり迅速かつ簡単に開発することができます。DTO の強力な機能や柔軟性は、データベースの作成やパフォーマンスのチューニングおよびメタデータの管理など、データベース管理やデータベース定義のタスク全般に幅広く利用することができます。

DTO はデュアル インターフェイスとして処理中のサーバーに実装されます。開発者は、OLE オートメーション コントローラーを使用することも、あるいは以下に挙げる多くのプログラム言語などを使用して COM クライアントを作成することもできます。

このマニュアルでは、DTO クラスを以下の機能のカテゴリ別に分類しています。

Pervasive PSQL エンジンの動作を構成および監視できるようにするには、ユーザーは最初にそのエンジンに接続する必要があります。このカテゴリでは、Pervasive PSQL データベース エンジンへの接続および接続の切断に必要な機能を提供します。

DtoSession オブジェクトがデータベース エンジンへの接続を管理します。

このカテゴリでは、Pervasive PSQL エンジンとクライアントを監視する機能および診断情報を提供します。

DtoMonitor オブジェクトとその従属オブジェクトによって、サーバーの監視機能および診断情報を提供します。また、DtoEngineInformation オブジェクトを使って DtoSession からエンジン情報を直接取得することもできます。

このカテゴリでは、ユーザーが Pervasive PSQL エンジンやクライアントを構成することができます。DtoCategories コレクションとその従属オブジェクトによって、この機能を提供します。

また、DtoLicenseMgr オブジェクトを使用すれば製品ライセンスの追加と削除も行えます。

このカテゴリでは、グループ化された機能によって、ユーザーはデータベース、データ辞書を新規作成することができます。また、テーブル、列およびインデックスの定義や削除も行えます。

DtoDictionary クラスとその従属オブジェクトによって、カタログ機能を提供します。

多くの DTO オブジェクトがその他の DTO オブジェクトのプロパティとして公開されています。この関係によって、開発者はオートメーション コントローラーを使用するプログラミングを簡略化する論理的なツリー形式の構造を使用することができます。多くのオブジェクトは、プロパティやメソッドにアクセスする場合に使うドット表記を使用して参照することができます。

DTO オブジェクト ツリーには 3 つの主要なブランチがあり、設定、監視、およびカタログ用のオブジェクトが論理的にグループ化されています。

次の表は、2 つの異なるバージョンの DTO の使用に関する情報を示しています。

Pervasive PSQL V8 SDK では新しい DLL がリリースされました。この DLL には新しいオブジェクトや既存のオブジェクトへの新しいプロパティが追加されています。下位バージョンとの互換性を保つために新しい DLL が追加されます。以前の DTO.DLL に 新しい DLL が追加されるわけではありません。両方の DLL がインストールされ Pervasive PSQL SDK で登録されるので、どちらの DLL を使用しても DTO アプリケーションを開発できます。新しい DLL を使用するためにアプリケーションを再コンパイルできない場合は、以前の DTO.DLL を使用する必要があります。ただし、以前の DTO.DLL を使用していると、新しいオブジェクトや既存のオブジェクトに追加された新しいプロパティを使用することができません。DTO2.DLL は、.NET Framework を含む 32 ビット開発環境をサポートします。

Pervasive PSQL v11 SP1 SDK では、.NET Framework を含む 64 ビット開発のための 64 ビット サポートが追加されました。

64 ビット アプリケーションで DTO を利用するためには、作成した 64 ビット アプリケーションと一緒に 64 ビット サーバーまたはクライアントをインストールする必要があります。前の表で示されているとおり、64 ビット サーバーまたはクライアントをインストールすると、64 ビット バージョン（W64DTO2.DLL）がインストールされ、32 ビット サーバーまたはクライアントをインストールすると、32 ビット バージョン（DTO2.DLL または DTO.DLL）がインストールされます。

アプリケーションと DLL がどのように相互作用するかをより良く理解するために、次のようなシナリオを検討します。

次の 3 つの DLL を持っていると仮定します。

そして、次のようなアプリケーションの実行可能ファイルがあるとします。

以下の表は、アプリケーションの実行可能ファイルと DLL を一緒に、32 ビット マシンおよび 64 ビット マシン上で実行してみた場合の結果を示しています。

このセクションでは、Visual Basic、Active Server Pages（ASP）および Delphi DTO を使用するためのセットアップ方法を説明します。

DTO は デュアル インターフェイス COM オブジェクトのライブラリなので、Visual Basic ではこれらのオブジェクトを使って作業する 2 つの方法があります。Active Server Pages を使用している場合、2 番目の方法を使う必要があります。第一にお勧めする方法は、プロジェクトにタイプ ライブラリを追加する方法です。この方法を使用すれば、VB で型のチェックを行うことができ、オブジクトの作成や関数のパラメーターに対して便利なドロップダウン オプション（Intellisense 機能）を開発者に提供することができます。

もう 1 つの方法は、CreateObject 関数を使用する方法です。これは実行時にオブジェクトを作成するため、型のチェックと Intellisense 機能がありません。

Visual Basic プロジェクトに Pervasive Distributed Tuning Library を追加するには、以下の手順に従います。

これで VB では DTO に含まれるすべてのオブジェクトを認識することができます。すべてのオブジェクトが参照可能になります。使用可能なオブジェクトを表示するには、以下の手順に従います。

ASP でオブジェクトのインスタンスを作成する場合は、この方法を使用する必要があります。CreateObject の構文は次のようになります。

ほとんどの DTO オブジェクトは、後でセッション オブジェクトから取得することができます。

ASP で DTO を使用するために必要な初期化は特にありません。ただし、次の点に注意してください。

デフォルトで、ASP は呼び出し間の状態の情報を保存しません。Microsoft IIS の組み込みオブジェクトである Session オブジェクトを使用して、オブジェクト参照と変数の状態を保存する必要があります。

たとえば、DTO バージョン 2 の DtoSession オブジェクトを初期化するには以下のように記述します。

Delphi で COM オブジェクトを使用するには、2 つの方法があります。Visual Basic と同様、第一にお勧めするセットアップ方法は Delphi プロジェクトにタイプ ライブラリをインポートする方法です。

もう 1 つの方法では、CreateOleObject 関数を使って直接 COM インターフェイスを呼び出すことができます。この関数は Automation オブジェクトの単一のインスタンスをインスタンス化します。

タイプ ライブラリをインポートし、必要な Pascal 宣言を生成するには、以下の手順に従います。

Distributed Tuning Objects のリファレンスは、機能別に 4 つの章に分かれています。このセクションでは、各章のオブジェクトの一覧を表示します。

DtoSession オブジェクトは DTO の中核的なオブジェクトです。アプリケーションから Pervasive PSQL サーバーへ接続する場合は、DtoSession オブジェクトを介して行います。特定のデータベース サーバーでセッションが要求された場合、DTO アプリケーションでは DtoSession オブジェクトを作成し、Connect メソッドを使用します。

DtoCategory オブジェクトと DtoCategories コレクションはデータベース エンジンの設定をグループ化しており、ユーザーはより詳細な設定を対象にして DtoSetting オブジェクトにアクセスすることができます。

DtoSetting オブジェクトと DtoSettings コレクションは、データベース エンジン、通信マネージャーおよびローカル リクエスター コンポーネントの特定の設定を公開しており、ユーザーはこれらの設定を変更することができます。通常、各カテゴリは設定のコレクションを公開します。

DtoSelectionItem オブジェクトと DtoSelectionItems コレクションには選択が可能な設定に対する全項目が含まれます。DtoSetting.AllPossibleSelections では、指定した設定に対する可能なすべての値のコレクションを返します。

DtoServices オブジェクトを使用すれば、ユーザーは Pervasive PSQL データベース サービスを開始、停止したりサービスの現在の状態を照会したりすることができます。

DtoLicenseMgr（DTO2）オブジェクトを使用すれば、ライセンスを追加、削除できるほかに、製品情報を見ることができます。

DtoMonitor オブジェクトを使用すれば、ユーザーはデータベース エンジンやその他関連するサービスに関するステータス情報をリアルタイムで取得することができます。

また、DtoMonitor オブジェクトでは、ファイル ハンドル、開いているファイルおよびライセンスの現在値、ピーク値、最大値などのリソース使用状況に関する情報も公開しています。ピーク値とは、そのエンジンを最後に再起動してから現在に至るまでの最大値です。

DtoOpenFile オブジェクトと DtoOpenFiles コレクションにはアクティブ ファイルに関する情報が含まれます。これを使用すれば、ユーザーは、開いているファイル数、それらのファイルを開いているユーザーおよびその他の関連情報を調べてファイル アクセスを監視することができます。

DtoFileHandle オブジェクト DtoFileHandles コレクションは、ユーザー名またはエージェント ID、接続番号、タスク番号、サイト、ネットワーク アドレス、オープン モード、レコード ロック タイプ、待ち状態、トランザクション状態を公開します。

DtoMkdeClient オブジェクトと DtoMkdeClients コレクションは、アクティブ クライアントに関する情報を公開します。特定のクライアントの場合、そのクライアントのアクティブ セッションがあるかどうかを調べ、アクティブ セッションがあった場合はそのセッションに関するデータを取得することができます。また、オプションでそのクライアントを終了することもできます。

DtoMkdeClientHandle オブジェクトと DtoMkdeClientHandles コレクションは、各ファイルの名前や関連情報が含まれるハンドル情報を公開します。

DtoMkdeVersion（DTO2）では、Pervasive PSQL エンジンのメジャー バージョンとマイナー バージョン、ビルド番号およびターゲット オペレーティング システムを公開します。

DtoEngineInformation（DTO2）では、メジャー バージョンとマイナー バージョン、DTI API バージョンおよびサーバーとクライアントのその他の情報を公開します。

DtoSqlClient オブジェクトと DtoSqlClients コレクションは、アクティブ SQL ユーザーの数や一覧および各クライアントに関する詳細情報など、SQL アクティブ ユーザーに関する情報を公開します。

DtoCommStat オブジェクトは、通信統計情報を公開します。適切な場合、現在値、ピーク値および最大値を照会することができます。

DtoProtocolStat オブジェクトと DtoProtocolStats コレクションは、サーバーで実行している各ネットワーク プロトコルに関する情報を公開します。

DtoDatabase オブジェクトと DtoDatabases コレクションは、データベース名、データベース フラグ、セキュリティ、テーブル定義などのデータベース カタログ情報の管理を担当します。

DtoDSN オブジェクトと DtoDSNs コレクションは、サーバーにある Pervasive PSQL DSN を表します。これらを使用して、新しい DSN を作成したり、既存の Pervasive PSQL ODBC DSN を管理したりすることができます。

DtoDictionary オブジェクトは、辞書ファイルに関連するすべての操作のルート オブジェクトです。このオブジェクトを使用して、辞書のオープン、辞書の作成、テーブル情報の取得、テーブルの追加または削除を行うことができます。

Tables コレクションにアクセスするには、DtoDatabase オブジェクトを使用する方法をお勧めします。

DtoTable オブジェクトと DtoTables コレクションは、テーブル名、列およびインデックスなどのテーブル情報の管理を担当します。

DtoColumn オブジェクトと DtoColumns コレクションは、列に関する情報の管理を担当します。

DtoIndex オブジェクトと DtoIndexes コレクションは、テーブルのインデックス定義を公開します。

DtoSegment オブジェクトと DtoSegments コレクションには、テーブル内で指定したインデックスのセグメントに関する情報があります。

コレクションとは、ほかの複数オブジェクトを含むオブジェクトです。

Set キーワードを使用して変数をコレクション オブジェクトに設定します。

ASP を使用する場合、通常は DtoSession と DtoDictionary という 2 つのオブジェクトのインスタンスのみを直接作成する必要があります。Active Server Pages でオブジェクトのインスタンスを作成する場合、IIS の組み込みオブジェクトである Server オブジェクトの CreateObject 構文を使用します。

ただし、データベース、DSN、テーブル、列、インデックスまたはセグメントなどのオブジェクトを新規作成する場合は、この同じ構文を使用します。各オブジェクトのプログラム ID は、前述の例で示す規則に従います。

その他のコレクションについては、前述の Visual Basic の Set 構文を使用することができます。

Visual Basic でコレクション内をループするには、For ループの使用とカウンターの使用という 2 つの方法があります。

For/Next ステートメントを使ってコレクション内をループする Visual Basic の構文を以下に示します。

カウンターを使ってコレクション内をループする Visual Basic の構文を以下に示します。

Pervasive の設定のカテゴリ一覧を表示する ASP のサンプル コードを以下に示します。

Count プロパティを使用してコレクション内のオブジェクトの数を調べます。

Count プロパティを使用してコレクション内のオブジェクトの数を調べます。

Item プロパティを使用して、コレクション内の特定のメンバー オブジェクトを取得します。

コレクション内のメンバー（要素）には序数を使ってアクセスすることができます。コレクションによっては、要素の一意のプロパティ（名前など）を使用して各要素にアクセスすることができます。すべての序数は 1 から始まります。

Item プロパティはコレクション オブジェクトのデフォルト プロパティなので、次の 2 つのステートメントは同一です。

Pervasive PSQL SDK には Visual Basic による完全な DTO サンプルがあります。このサンプルは、SDK のサンプルとヘッダー ファイルをインストールした file_path\PSQL\SDK\SAMPLES\DTI\VBASIC にあります。SDK のコンポーネント、コード スニペット、およびサンプルは、Pervasive PSQL Web サイト http://www.pervasivedb.com から入手できます。

Pervasive PSQL ファイルのデフォルトの保存場所については、『Getting Started with Pervasive PSQL』の Pervasive PSQL ファイルはどこにインストールされますか？を参照してください。