この章では、Btrieve アプリケーションのデバッグに役立つと思われる情報を示します。以下の項目が含まれています。

MicroKernel の［トレース オペレーションの実行］設定オプションを選択すると、各 Btrieve API 呼び出しをトレースし、その結果をファイルに保存できます。これは、アプリケーションのデバッグに有効です。以下に、サンプル トレース ファイルを示します。

オペレーションごとに、MicroKernel に渡した値と MicroKernel から返された値を示しています。入力値は <In> で表され、出力値は <Out> で表されています。それぞれの後ろに、オペレーションが処理された順序を示す番号が続くので、<Out> 0016 は <In> 0016 の結果となります。Opcode フィールドは、実行されたオペレーション コードを示します。Status フィールドは、返されたステータス コードを示します。

Crs ID は、MicroKernel が要求に割り当てたカーソル ID、つまり、ハンドルです。この情報は、複数のクライアントをサポートしたり、複数のカーソルで単一のクライアントをサポートするアプリケーションのデバッグに有効な場合があります。

Db Length は、データ バッファー長を反映します。Keynum は、キー番号を反映します。Clnt ID は、BTRVID 関数と BTRCALLID 関数で使用されるクライアント ID パラメーターを反映します。DBuf は、データ バッファーの内容を反映します。KBuf は、キー バッファーの内容を反映します。トレース ファイルは、MicroKernel の設定に応じて、データ バッファーおよびキー バッファーの内容を切り詰めます。

Get Direct/Chunk オペレーション（23）を行おうとすると、アプリケーションはステータス コード 62 を受け取ることがあります。アプリケーションでは間接ランダム ディスクリプター オプション（サブファンクション 0x80000001）を指定しているのに、トレースを有効にすると、実際には MicroKernel が直接ランダム ディスクリプター オプション（サブファンクション 0x80000000）を受信していることがわかります。

間接チャンク オプションでは、アプリケーションはデータの取得後、そのデータが Btrieve 呼び出しの実際のデータ バッファー パラメーターに返されるのではなく、データを格納したいアプリケーションのメモリ ブロックに返されるよう、データ アドレスへのポインターを指定することができます。しかし、MicroKernel がアプリケーションのメモリへの直接アクセスを行わない環境でアプリケーションが動作しているので、Btrieve クライアント リクエスターは間接チャンク要求を直接チャンク要求に変換してから、その要求を MicroKernel に送ります。

すべてのアプリケーションは、アプリケーションと MicroKernel の間の通信に必ずプロセス間通信（IPC）を使用します。IPC が要求されるため、MicroKernel はアプリケーションのメモリにアクセスしないので、クライアント リクエスターは単一の連続メモリ ブロックを割り当て、そのメモリ ブロックを指すようにすべてのデータ ポインターを調整します。MicroKernel から戻ると、リクエスターは間接オプションに対応する形式にデータ バッファーを変換し、返されたデータ チャンクをアプリケーションのメモリ ブロック内の指定された間接アドレスへ移動します。

Windows 98/ME または Windows NT 以降をターゲットにするマルチスレッド コンソール アプリケーションを開発している場合は、起こり得る CTRL-C キーストロークを処理するようにコントロール ハンドラー ルーチンを設定する必要があります。このコントロール ハンドラー ルーチンでは、Reset オペレーション（28）または Stop オペレーション（25）のいずれかを発行することによって、すべての Btrieve クライアントをクリーンアップする必要があります。クリーンアップ プロセスは、アプリケーションが CTRL-C イベントをオペレーティング システムに渡す前に終了しなければなりません。

システムがスレッドを終了したときにアプリケーションがアクティブのままになっている場合、MicroKernel はアプリケーションとの接続をクリーンアップできず、さらに多くのシステム リソースを強制的に割り当てます。このため、パフォーマンスの低下が発生し、エンジンのシャットダウンに必要な時間が大幅に増えます。コントロール ハンドラー ルーチンの詳細については、Microsoft のドキュメントを参照してください。

MicroKernel は、必要に応じてディスク領域を割り当てます。アプリケーションが新しいレコードを挿入するときにファイル内に十分なスペースがない場合、MicroKernel は追加のデータ ページとインデックス ページをファイルに自動的に割り当てます。割り当てられた各ページのサイズは、ファイルが作成されたときのページ サイズと同じです。MicroKernel は、新しいファイル サイズを反映するためにディレクトリ構造も更新します。

MicroKernel がファイルにスペースを割り当てると、そのスペースはファイルが存在する間割り当てられたままになります。