ここでは、以下のトピックについて説明します。

Zen には、対話型の Maintenance GUI おびコマンド ラインの Maintenance ツールが用意されています。どちらのバージョンも以下のファイル操作およびデータ操作を行います。

2 つのユーティリティは基本的に同じですが、機能が異なる部分が多少あります。たとえば、対話型 Maintenance ツールでは、定義したファイルおよびキー仕様に基づいてディスクリプション ファイルを作成することができますが、コマンド ライン Maintenance ツールでは、サーバー上でファイルの Continuous オペレーションを直接開始または停止することができます。

Maintenance ツールを使用する前に、ファイル、レコード、キー、セグメントなどの Btrieve の基本概念について熟知しておく必要があります。これらのトピックスの詳細については、『Zen Programmer's Guide』を参照してください。

対話型 Maintenance ツールは、Windows 32 ビットおよび 64 ビット プラットフォームで実行される Windows アプリケーションです。このツールは、グラフィカル インターフユーザェイスを使用した場合、またはディスクリプション ファイルを作成したい場合に使用します。このセクションには次の主なトピックがあります。

それぞれの主なトピックにはそのトピックに固有のタスクがあります。

MicroKernel データ ファイルは、オペレーティング システムのファイル サイズ上限を超えた容量を持つことが可能です。データを、MicroKernel の拡張ファイルからシーケンシャル ファイルにエクスポートした際、実際の形式の違いから、そのシーケンシャル ファイルの容量がデータベース エンジンのファイル サイズ上限を超える場合があります。

大きなサイズのファイルをエクスポートする際、対話型 Maintenance ツールでは、シーケンシャル ファイルがファイル サイズの上限（2 GB）を超えていることを検出すると、エクステンション ファイルの作成が開始されます。この処理は自動的に行われます。エクステンション ファイルおよび元のシーケンシャル ファイルは、同じボリューム内に存在する必要があります。ファイルのサイズの制限は、オペレーティング システムやファイル システムによって異なるので注意してください。2 GB というサイズはデータベース エンジンでサポートされる制限サイズです。

エクステンション ファイルの名前には、ベース ファイルと似た名前を付ける方式が使用されます。エクステンション ファイルを示すのに、ネイティブな MicroKernel エンジン エクステンション ファイルがキャレット（"^"）を使用するのに対し、シーケンシャル ファイルのエクステンション ファイルはチルダ（"~"）を使用するので、同じベース ファイル名を持つ既存のエンジン拡張ファイルを上書きするのを防ぎます。最初のエクスポート エクステンション ファイルには、ベース ファイル名に ".~01" という拡張子が付きます。次のエクステンション ファイルには、ベース ファイル名に ".~02" というように拡張子が付けられます。これらの拡張子は 16 進形式で追加されます。

名前付け規則は 255 までのエクステンション ファイルをサポートします。したがって、最大ファイル サイズは 256 GB です。

また、シーケンシャル ファイルからデータをインポートする場合は、ファイルが拡張されているかどうかがチェックされ、エクステンション ファイルからデータがロードされます。

スペースを含む長いファイル名は、サポートされるすべてのオペレーティング システムで使用できます。参照対象となるすべてのファイル名には、埋め込みスペースを含むことが可能であり、また 8 バイトを超える名前も使用可能です。

Btrieve の古いバージョンでは、Open や Create など、パスに基づくオペレーションの際に、ファイル名の最後にスペースを追加することができました。このバージョンでも、デフォルトとしてこれが設定されており、操作に支障をきたしませんが、バージョン埋め込みスペースを含むファイル名やディレクトリ名も正しく認識する機能を利用したい場合は、クライアント リクエスターの［スペースを含むファイル/ディレクトリ名］設定をオンに設定します。デフォルトの設定はオンです。

このオプションをオフに設定した場合でも、埋め込みスペースを含む名前を持つファイルにアクセスする際に、アプリケーションがファイルを開く、または作成する BTRV/BTRVID/BTRCALL/BTRCALLID コールを行うとき、その名前を二重引用符で囲めば、使用することができます。

Zen ではレコードおよびページによる 2 種類のデータ圧縮を提供します。これら 2 種類のデータ圧縮は、別々に使われることもあれば、一緒に使われることもあります。2 つの圧縮タイプの主な目的はいずれも、データ ファイルのサイズを減らし、データのタイプとデータ操作のタイプに応じてより速いパフォーマンスを提供することです。

レコード圧縮には 6.0 以上のファイル形式が必要です。レコード圧縮により、多数の繰り返し文字を含むレコードの格納に必要なスペースを大幅に削減できます。データベース エンジンは、5 つ以上連続する同一文字を 3 バイトに圧縮します。

ファイルの作成時、指定されたレコード長に余裕を持たせるため、データベース エンジンは自動的に指定されたより大きいページ サイズを使用します。圧縮されていないレコードが、使用できる最大ページに収まりきらないほど大きい場合、データベース エンジンは自動的にレコード圧縮をオンにします。

圧縮レコードの最終的な長さは、ファイルに書き込まれるまで決定されないため、データベース エンジンはレコード圧縮されたファイルを可変長レコード ファイルとして作成します。レコードの圧縮されたイメージは可変長レコードとして格納されます。アプリケーションがレコードの追加、更新、削除を頻繁に行うと、個々のレコードはいくつかのファイル ページに断片化されます。データベース エンジンは 1 つのレコードを取得するために複数のファイル ページを読み取らなければならない場合があるので、この断片化によってアクセス時間が遅くなるおそれがあります。

『Zen Programmer's Guide』のページ サイズの選択、ファイル サイズの予測およびレコード圧縮を参照してください。

ページ圧縮には 9.5 以上のファイル形式が必要です。内部的には、Zen データ ファイルはさまざまな種類のページの連続です。ページ圧縮は、ファイル内のデータ ページの圧縮と復元を制御します。

ファイルが物理ストレージから読み取られると、データ ページは復元されてメモリ キャッシュに保持されます。レコードの読み取りと更新は、メモリ キャッシュ内の圧縮されていないデータに対して行われます。書き込み操作が行われると、データ ページは圧縮されて物理ストレージに書き込まれます。圧縮されたページが、次回アクセスされるまで保持されるかどうかは、キャッシュ管理によって異なります。

データの種類によって圧縮しても意味がない場合、データベース エンジンはそのデータを圧縮しないで物理ストレージに書き込みます。

レコード圧縮、ページ圧縮、あるいはその両方を使用することで得られる利点は、圧縮されるデータのタイプによって異なります。次の表では、データ圧縮を使用するかどうかを判断するための一般的な要因を説明します。

オペレーティング システムの［スタート］メニューまたはアプリ画面から、あるいは Zen Control Center の［ツール］メニューから Maintenance ユーティリティにアクセスします。Maintenance ユーティリティのメイン ウィンドウは次のようになっています。

対話型 Maintenance ツールには、以下のメニューが用意されています。

Maintenance ツールのヘルプを使用するには、ヘルプの必要なダイアログ ボックスで［ヘルプ］をクリックするか、以下のような［ヘルプ］メニューのコマンドを選択します。

このセクションでは、構築するファイルおよびキー仕様に基づいて新しいファイルを作成する［ファイル情報エディター］に関する一般的な説明を行います。このエディターでは、既存ファイルの情報をロードできるため、既存データ ファイルのファイル仕様やキー仕様の確認に便利です。また、既存ファイルのファイル仕様やキー仕様に基づいた新規ファイルの作成も可能です（コマンド ライン Maintenance ツールである butil の clone コマンドと同様）。

エディターの上部には、以下のボタンが表示されます。

［ファイル情報エディター］の上部の［データ ファイル情報］領域には、以下のコントロールが含まれます。

［ファイル情報エディター］の中央部に［ファイル仕様］領域があります。次の表はこのボックス内のコントロールの説明です。

ダイアログ ボックスの左下部には［キー］グループ ボックスがあります。次の表はこの領域のコントロールの説明です。これらのコントロールは、現在のキー セグメントだけでなく、［キー］リストで選択されているキーに固有です。これらの設定を変更した場合、指定したキーのすべてのセグメントに対して変更が適用されます。

ダイアログ ボックス中央下部の［キー］リストにはファイルに定義されているキー番号が表示されます。バージョン 6.x 以降のファイルでは、このキー番号が連続した数値である必要はありません。Maintenance ツールでは、選択されたキーの仕様が、ダイアログ ボックス左下部の［キー］ボックスに表示されます。

また、ダイアログ ボックス中央下部の［セグメント］リストには、［キー］リストで選択されたキーに定義されている、キー セグメント番号が表示されます。Maintenance ツールでは、選択されたセグメントの仕様が、ダイアログ ボックス右下部の［セグメント］ボックスに表示されます。

また、［キー］と［セグメント］リストには、以下のボタンが表示されます。

これらのボタンは、作成するファイルのキー仕様を設定するもので、既存ファイルのキーに対して使用することはできません。既存ファイルのインデックスを作成または削除する場合は、インデックスの作業を参照してください。

ダイアログ ボックスの右下部には［キー セグメント］グループ ボックスがあります。次の表はこの領域のコントロールの説明です。これらのコントロールは、［セグメント］リストで選択されているセグメントに固有のものです。

複数のレコードが、インデックス キーに同一の重複した値を持つことができます。重複キー値を持つレコードを記憶しておく 2 つの方法は、リンク重複および繰り返し重複と呼びます。

リンク重複の手法では連鎖技術を使用し、グループ内の各レコードをポインターを使用して隣のレコードと連結します。同一インデックス ページ上の各エントリは 1 組のレコード ポインターを持ち、キー値が重複しているレコードの連鎖の最初と最後のリンクを示します。このため、各キー ページのエントリは繰り返し重複インデックスより 4 バイト長くなります。さらに、データ ページの各レコードでは、リンク重複インデックスごとに 8 バイトのオーバーヘッドが必要です。この 8 バイトは、連鎖中の次のレコードと前のレコードを指す 2 つのレコード ポインターです。

最初のレコード ポインターは、最初に、または最も古い時期に格納されたレコードのアドレスを保持します。2 番目のポインターは最近または最後に格納されたレコードのアドレスを保持します。最初のレコードが書き込まれた後でほかのレコードが追加される前には、キー ページ エントリ上の両方のポインターに最初のレコードのアドレスが保持されています。その後にレコードが追加されると、2 番目のポインターが追加された各レコードを指すように変更されます。このことにより、最後のレコードのレコード ポインターが、レコードの追加時にデータ ページ内に構築される前のレコードの連鎖のリンクとして使用されること、および前のレコードの検索に使用されることが可能になります。

繰り返し重複の手法では、各重複キー値はインデックス ページとデータ ページ上のレコード内の両方に格納されます。各キー値には、レコード ポインターが 2 つではなく 1 つだけあります。この手法ではデータ レコードの連鎖が不要で、レコードごとの 8 バイトのオーバーヘッドを節約します。キー値が重複レコードごとに繰り返されるため、インデックスのサイズが大きくなるという影響があります。

リンク重複および繰り返し重複の手法は、以下の基準によって比較することができます。

リンク重複インデックスは、データが追加された順序で重複を取得します。繰り返し重複インデックスは、データがファイル内に存在する順序で重複を取得します。ファイル内での位置は制御できないため、順序はランダムであると考える必要があります。

リンク重複インデックスでは、各重複キー値の最初の出現で 12 バイト余分に必要になります。これには、各レコードについての 8 バイトとキー ページ エントリとしての 4 バイトが含まれます。ただし、重複レコードはキー ページでこれ以外の余計な空間を必要とせず、レコードごとに 8 バイトが追加されるだけです。したがって、キー値ごとの重複の数が増加してキー値のサイズが増加しても、リンク重複インデックスはキー ページが使用するストレージ空間を著しく節約することができます。ただし、重複キーを持つレコードがほとんどファイルに格納されていないか、キー長が非常に短い、またはその両方に該当する場合は、使用するストレージ空間は増加します。

インデックス検索に関わるページが少ない場合、ディスクから読み取るページ数が少なくなるため、結果として速いパフォーマンスが得られます。リンク重複手法は一般的に少しの物理ストレージ空間しか使用しないため、速いパフォーマンスが得られます。繰り返し重複手法は、重複のあるキー数が少ない場合にのみパフォーマンスでの利点があります。

データベース エンジンは、複数の並行トランザクションが同一ファイルに対し同時にアクティブである場合に、ページ レベルの並行性を提供します。これは、キー ページへのほとんどの変更と、データ ページへのすべての変更に適用されます。並行性とは、同一ページが別個のトランザクションからの複数の保留中の変更を同時に持つことができることを意味します。また、これらのトランザクションはどのような順序でもコミットすることができます。繰り返し重複インデックスはこの並行性を最もよく利用しています。

リンク重複インデックスでは、繰り返し重複には存在しない並行性の制限が追加されます。新しい重複データが作成された場合、そのレコードはリストの最後で別のレコードにリンクされます。このレコードのリンクにより、1 つではなく 2 つのレコードがロックされることになります。すべての重複データはリンク レコードの連鎖の最後に追加されるため、重複は一度に 1 つしか追加できません。

このようなレコード ロックの衝突により、通常、ほかのクライアントは最初のトランザクションがコミットされるまで待機状態になります。並行動作が行われる環境では、すべての新規レコードが同じ重複値を使用する場合、並行性は事実上一度に 1 トランザクションというレベルまで低減します。さらに、トランザクションが大きいかまたは長く継続する場合、この連続状態がパフォーマンスに非常に大きく影響します。

並行環境で更新されるデータベースに繰り返し重複インデックスを使用した場合、パフォーマンスは一般的に向上します。したがって、リンク重複手法を使用せざるを得ない理由がある場合を除き、並行環境で更新されるデータベースには繰り返し重複インデックスを使用してください。

ファイル情報エディターを使用して次の作業を行うことができます。

既存ファイルから情報をロードした場合、既存ファイルを編集するわけではありません。既存ファイルに関する情報のコピーのみがロードされます。一般的に、ファイル情報エディターでほかの作業をする前にファイルをロードしますが、これは必須ではありません。

ファイル情報エディターで、現在の情報または入力した新しい情報に基づいた新規ファイルを作成することができます。

コメントは、ディスクリプション ファイルを作成したときに、その先頭に出力されます。たとえば、コメント「これは私のファイルです」はディスクリプション ファイルの先頭に /* これは私のファイルです*/ と表示されます。ディスクリプション ファイル作成後にコメントを追加する場合は、コメントを追加してファイルを作成し直す必要があります。

未使用スペースを除去することにより Btrieve データ ファイルのコンパクト化を行うことができ、通常ファイルのサイズを小さくすることができます。この処理は、コマンド ライン Maintenance ツール（Btrieve データ ファイルをコンパクト化するにはを参照）を使用して実行することもできます。

オルタネート コレーティング シーケンス（ACS）を使用して、文字型のキー（STRING、LSTRING および ZSTRING）を標準 ASCII 照合順序とは異なる順序でソートすることができます。1 つまたは複数の照合順序を使用して、次のようにキーをソートすることができます。

ファイルには、キーごとに異なる ACS を持つことができますが、1 つのキーには 1 つの ACS のみです。したがって、キーがセグメント化されている場合、各セグメントはそのキーに指定された ACS を使用するか、または ACS をまったく使用しないかのいずれかになります。あるファイルに、一部のセグメントにだけ ACS が指定されているキーがある場合、Btrieve は指定されたセグメントのみ、ACS を使用してソートします。

ISR テーブルは ISO の標準ロケール テーブルに基づいており、Zen によって提供されます。ISR テーブルは Zen のデータベース エンジンと一緒にインストールされた collate.cfg ファイルに格納されています。複数のデータ ファイルが 1 つの ISR を共有できます。

MicroKernel は、個々のデータ ファイルにそれぞれオーナー ネームを設定することにより、データ ファイルへのアクセスを個別に制限することができます。オーナー ネームを提供するユーザーのみが、ファイルに対する読み取り/書き込みが可能となります。このトピックでは、Maintenance ツールを使用したオーナー ネームの管理について説明します。詳細については、『Advanced Operations Guide』の「オーナー ネーム」トピックを参照してください。

オーナー ネームによる制限があるテーブルへリレーショナル アクセスしようとしたときに、そのオーナー ネームの文字列値を提供しないと ODBC エラーになります。たとえば、これは ZenCC でテーブルを削除しようとする場合などです。GRANT または SET OWNER ステートメントを使用すれば、セッション内で 1 つまたは複数のテーブルにオーナーネームを指定することができます。特定のユーザーまたはグループにアクセス権を付与して、ODBC 経由でテーブルをリレーショナル操作するには、GRANT ステートメントを使用します。Master ユーザーは GRANT ステートメントに正しいオーナー ネームを使用する必要があります。詳細については、『SQL Engine Reference』の GRANT を参照してください。

SET OWNER ステートメントを使用して、現在のデータベース セッション中にファイル アクセスを可能にするオーナー ネームを 1 つまたは複数提供します。詳細については、『SQL Engine Reference』の SET OWNER を参照してください。

オーナー ネームを設定すると、データ ファイルへのアクセスが制限されます。オーナー ネームをクリアすると、この制限が解除されます。

ファイル情報レポートの作成は、データベース エンジンのトランザクション一貫性保持機能でファイルのログを作成できるかどうかを確認する際に便利です。レポートは、ファイルにシステム データがあるかどうか、キーがユニークであるかどうかを表示します（ユニーク キーには、重複が許可されていることを示す D フラグが付きません）。情報レポートはファイルのメタデータを提供します。この情報は、問題の解決に使用したり、よく似たファイルを作成するのに役立ちます。

情報レポートを作成する手順を以下に示します。

インデックスは、特定キーのすべてのキー値をソートするためのものです。Btrieve アクセスではオーバーラップするインデックス（列の一部を含むインデックス）が許可されます。ODBC を介したリレーショナル アクセスでは、オーバーラップするインデックスは許可されません。［エディターの起動］ボタンをクリックして表示できるファイル情報エディターを使用して、オーバーラップするインデックスを作成することができます。

インデックスに関連する以下の作業を行います。

ファイルにキーが定義されていない場合、ファイルのインデックスを作成することはできません。ファイル情報エディター（ファイル情報エディターを参照）を使用してキーを作成することができます。

インデックスを削除する前に、アプリケーション プログラムが行うアクセスについてよく理解しておいてください。必要なインデックスがないと、GET NEXT などの機能が動作しません。その結果、アプリケーション プログラムは正常に機能しなくなります。

［データ］メニューのコマンドを使用して、データ ファイルのレコードをインポート、エクスポート、およびコピーすることができます。また、ロール フォワード機能を利用して、システム エラー発生後にデータを修復することも可能です。

データを保存すると、ASCII ファイルのレコードは、以下の形式になります。以下の仕様に従うことにより、ASCII テキスト エディターを使用してロード可能なファイルを作成できます。多くのテキスト エディターでは、バイナリ データを編集することができないので注意してください。

以下のデータに関する作業は Maintenance ツールを使用して行うことができます。

Maintenance ツールでは、ASCII ファイルから標準データ ファイルにレコードをインポートすることができます。この処理では、データ変換は行われません。テキスト エディター、または Maintenance ツールを使用してインポート ファイルを作成することが可能です（ASCII ファイルへのレコードのエスクポートを参照）。

Maintenance ツールでは、データ ファイルから ASCII ファイルにレコードをエクスポートすることができます。

Maintenance ツールでは、MicroKernel データ ファイルから別の MicroKernel データ ファイルにデータをコピーすることができます。指定するデータ ファイルの両方のレコード長は、同じでなければなりません。

『Advanced Operations Guide』の「ログ、バックアップおよび復元」を参照してください。

butil はコマンド ライン形式のインターフェイスを使用したい場合、または Continuous オペレーションを開始または停止したい場合に使用します。この実行可能プログラムは、butil.exe（Windows の場合）および butil（Linux ベースのシステムの場合）です。コマンド プロンプトで butil コマンドを実行する、または、実行可能なバッチ スクリプトとして実行することができます。butil コマンドを実行する前に、ここで説明する当コマンドの概念や構文を理解してください。

Btrieve の Maintenance コマンド ライン ツールでは、以下のファイル処理およびデータ処理を行います。

butil は実行を完了すると、終了コードまたは DOS エラー レベルのリターン コードをオペレーティング システムに返します。リターン コードの種類は次の表に示すとおりです。

次の表は、butil で使用できるコマンドの一覧です。表内のリンクから、詳細な情報へ移動できます。

各コマンドの使用方法を表示するには、ファイル サーバー上のプロンプトで butil コマンドを入力します。

butil の形式は以下のとおりです。

コマンド ファイルは、以下の処理に使用します。

コマンド ファイルには、コマンド ラインで必要な情報と同じものが含まれます。

Maintenance ツールのコマンド ファイルを作成する際、以下の規則に従ってください。

以下は、コマンド ファイルの例 copycrs.cmd です。このファイルでは、butil - clone コマンドを呼び出し、course.mkd ファイルを複製することによって newcrs.mkd ファイルを作成します。次に -create コマンドを呼び出し、newfiles.des ディスクリプション ファイルのディスクリプションを使用して newfile.dta ファイルを作成します。

以下のコマンドでは、copypats.cmd ファイルを使用して copypats.out ファイルに書き込みを行います。

ディスクリプション ファイルは、データ ファイルとインデックスの作成に使用するファイルのディスクリプションおよびキー仕様を含む、ASCII ファイルです。作成したファイルの情報を保存するための媒体としてディスクリプション ファイルを使用することもできます。ディスクリプション ファイル形式の詳細については、『Advanced Operations Guide』の「ディスクリプション ファイル」を参照してください。

データベース エンジンの データ ファイルは、オペレーティング システムのファイル サイズ上限を超えた容量を持つことが可能です。データを、MicroKernel の拡張ファイルからシーケンシャル ファイルにエクスポートした際、実際の形式の違いから、そのシーケンシャル ファイルの容量がデータベース エンジンのファイル サイズ上限を超える場合があります。

大きなサイズのファイルがエクスポートされる際、対話型 Maintenance ツールでは、シーケンシャル ファイルがオペレーティング システムのファイル サイズの上限（2 GB）を超えていることを検出すると、エクステンション ファイルの作成が開始されます。この処理は自動的に行われます。エクステンション ファイルおよび元のシーケンシャル ファイルは、同じボリューム内に存在する必要があります。エクステンション ファイルの名前には、ベース ファイルと似た名前を付ける方式が使用されます。エクステンション ファイルを示すのに、ネイティブな MicroKernel エンジン エクステンション ファイルがキャレット（"^"）を使用するのに対し、シーケンシャル ファイルのエクステンション ファイルはチルダ（"~"）を使用するので、同じベース ファイル名を持つ既存の MicroKernel エンジン拡張ファイルを上書きするのを防ぎます。最初のエクスポート エクステンション ファイルには、ベース ファイル名に ".~01" という拡張子が付きます。次のエクステンション ファイルには、ベース ファイル名に ".~02" というように拡張子が付けられます。これらの拡張子は 16 進形式で追加されます。

名前付け規則は 255 までのエクステンション ファイルをサポートしますが、現在のエクステンション ファイルの最大数は 64 です。したがって、最大ファイル サイズは 128 GB です。

シーケンシャル ファイルに対する、サイズの大きなファイルの Save または Recover については、それぞれのコマンドを参照してください。また、シーケンシャル ファイルからデータをインポートする場合は、そのファイルが拡張されているかどうかがチェックされ、エクステンション ファイルからデータがロードされます。

MicroKernel を使用すると、ファイルのオーナー ネームを指定することにより、個々のファイルへのアクセスを制限することができます。オーナー ネーム文字列は暗号化にも使用されます。

エラー メッセージをリダイレクトする場合は、フル パス名（ドライブ文字または UNC パスを含む）を入力します。

「対話型 Maintenance ツール」セクションの、ASCII ファイル形式のインポートとエクスポートを参照してください。

Windows または Linux で butil を使用する際、データ ファイルが現在のディレクトリに存在する場合は、パスを指定する必要はありません。

このトピックでは、butil コマンドの Copy、Load、Recover、および Save を使用したデータのインポートおよびエクスポートの詳細について説明します。

copy コマンドは、MicroKernel ファイルの内容を、別のファイルにコピーします。copy は、入力データ ファイルの各レコードを取得して、出力データ ファイルに挿入します。両ファイルのレコードのサイズは同じである必要があります。レコードのコピー後、copy によって新しいデータ ファイルに挿入されたレコードの総数が表示されます。

copy コマンドを使用することにより、古いファイルからのデータと新しいキー属性を持つデータ ファイルを作成できます。

以下のコマンドは、course.mkd のレコードを newcrs.mkd にコピーします。course.mkd 入力ファイルに、オーナー ネームは必要ありませんが、newcrs.mkd 出力ファイルでは、オーナー ネーム Pam が使用されています。

この例から最初の /O を省略した場合、オーナー ネーム Pam は、出力データ ファイルではなく、入力データ ファイルのものとして認識されます。

ファイルをコピーするときに、元のファイルとコピーされるファイルの両方のオーナーネームが必要な場合、-copy オプションでは次の例に示すように、両方のオーナーネームを指定します。

最初のオーナーネーム d3ltagamm@ は originalFile を開くために必要です。2 番目のオーナーネーム V3rs10nXIII は copiedFile の作成に使用します。

オーナーネームが対話形式で指定される場合、このコマンドは次に示す例のようになります。

これを実行すると、最初にユーザーは originalFile にアクセスするためのオーナーネームの入力を求められます。そのファイルが開いたら、次に copiedFile に割り当てるオーナーネームの入力が求められます。

load コマンドは、入力 ASCII ファイルのレコードをファイルに挿入します。入力 ASCII ファイルは、1 つのファイルまたは拡張ファイル（ベース ファイルと複数のエクステンション ファイル）のどちらでもかまいません。load コマンドでは、入力 ASCII ファイルのデータは変換されません。データ ファイルへのレコード移動後、ロードされたレコードの総数が表示されます。

load コマンド実行前には、入力 ASCII ファイルおよびデータ ファイルを作成する必要があります。入力 ASCII ファイルは、標準のテキスト エディターやアプリケーションを使用して作成できますが、そのファイル形式（ASCII ファイル形式のインポートとエクスポートを参照）に従う必要があります。データ ファイルは、Create コマンドまたは Clone コマンドを使用して作成できます。

以下の例では、シーケンシャル レコードを course.txt から course.mkd に読み込みます。course.mkd のオーナー ネームは Sandy です。

recover コマンドは、MicroKernel ファイルからデータを取り出し、Load コマンドで使用する入力 ASCII ファイルと同じ形式の ASCII ファイルに書き込みます。これは、破損した MicroKernel ファイルから、一部または全部のデータを取り出すときに便利です。recover コマンドは、すべてではないにしても、ファイルのレコードの多数を取り出すことができます。この後は、load コマンドを使用し、新しい MicroKernel ファイルに回復したレコードを挿入します。

ソース ファイルの各レコードでは、recover コマンドで可変ページ エラー（ステータス コード 54）が発生した場合、現在のレコードから取得できるすべてのデータをシーケンシャル ファイルに書き込み、回復処理を継続します。

ツールでは、以下のメッセージが表示されます。

以下のステートメントでは、course.mkd からレコードを取り出し、course.txt に書き込みます。

save コマンドは、指定したインデックス パスを使用して MicroKernel ファイルからデータを読み込み、load コマンドで使用する形式に対応した ASCII ファイルに書き込みます。その後、その ASCII ファイルを編集し、load コマンドを使用して編集後のデータを、別のデータ ファイルに保存することができます。ASCII ファイル形式の詳細については、ASCII ファイル形式のインポートとエクスポートを参照してください。

save は、入力データ ファイルの各レコードに対して、出力 ASCII ファイルにレコードを 1 つ作成します。完了後、save によって保存されたレコードの総数が表示されます。

ツールでは、以下のメッセージが表示されます。

以下の 2 つの例は、save コマンドを使用した、データ ファイルからのレコード取得方法です。

この例では、newcrs.idx 外部インデックス ファイルを使用して course.mkd からレコードを取得し、それらを course.txt という名前のシーケンシャル テキスト ファイルに保存します。

この例では、キー番号 3 を使用して course.mkd からレコードを取得し、それらを course.txt という名前のシーケンシャル テキスト ファイルに保存します。

このトピックでは、次の表に示す各種 butil コマンドを使用したデータ ファイルの作成、変更、および管理に関する詳細について説明します。また、Btrieve データ ファイルの未使用スペースの削除に関して Btrieve データ ファイルのコンパクト化で説明します。

clone コマンドは、既存ファイルと同じファイル仕様（オーナー ネームを含まず、補足インデックスを含む）を持つ、空の新規ファイルを作成します。新しいデータ ファイルには、既存ファイルのすべての定義済みキー属性（キー位置、キー長、重複キー値など）が含まれます。

clone コマンドでは、ファイル情報（「システム データ」を参照）に影響する MicroKernel 設定オプションのすべてが無視されます（ファイル バージョンを除く）。clone コマンドは、［作成ファイルのバージョン］オプションで指定したデータベース エンジンのファイル バージョンを使用して新規ファイルを作成します。

Btrieve 6.0 以降では、ページ サイズが 1024 バイトのデータ ファイルで最大 23 のキー セグメントを使用することができるため、clone コマンドでは、既存データ ファイルに 24 のキー セグメントが含まれ、ページ サイズが 1024 バイトの場合、新規データ ファイルのページ サイズは 2048 バイトに設定されます。これは、既存データ ファイルがバージョン 6.0 より前の形式で、データベース エンジン ロードの際に、［作成ファイルのバージョン］オプションが 5.x または 6.x に設定されていない場合に発生します。

バージョン 7.x 以前のファイルを複製する場合は、作成する新規ファイルのバージョン設定を確認してください。たとえば、6.15 ファイルを 9.5 形式で複製する場合は、データベース エンジンのファイル互換性プロパティで［作成ファイルのバージョン］オプションを 9.5 に設定します。

ステータス コード 30（指定されたファイルは MicroKernel ファイルではありません）が発生し、ソース ファイルのヘッダー ページが破損している可能性がある場合、ディスクリプション ファイルで Create コマンドを使用して新規の MicroKernel ファイルを作成します。

以下のコマンドは、course.mkd ファイルを複製して newcrs.mkd ファイルを作成します。

close コマンドは、ファイルの最後のクライアント接続が閉じた後もファイルを開いたままにしておくための［ファイルを閉じるまでの待ち時間］設定を上書きする要求をデータベース エンジンに送信します。その後、これらの開いているファイルは直ちに閉じられます。このコマンドは、すべてのファイルに対して、または単一のファイル、ファイルのリストに対して実行することができます。ファイル パラメーターを指定しないで close を実行した場合は、閉じるときに遅延待ちするすべての開いているファイルに適用されます。サーバー パラメーターを指定しないで実行した場合は、localhost と見なされます。

このコマンドを使用すれば、ファイルのコピーなど特定の操作を実行する前に、ファイルが確実に閉じられているようにすることができます。詳細については、パフォーマンス チューニング プロパティの［ファイルを閉じるまでの待ち時間］を参照してください。

clrowner コマンドは、MicroKernel ファイルのオーナー ネームをクリアします。

以下のコマンドは、tuition.mkd のオーナー ネームをクリアします。オーナー ネームは Sandy です。

create コマンドは、ディスクリプション ファイルで指定されている属性を使用して、空の MicroKernel ファイルを作成します。create コマンドを実行する前に、新しいキー属性を指定するディスクリプション ファイルを作成する必要があります。詳細については、『Advanced Operations Guide』の「ディスクリプション ファイル」を参照してください。

以下のコマンドは、create.des ディスクリプション ファイルで定義された内容を使用し、ファイル course.mkd を作成します。

キー 0 は、重複可能で変更不可能な文字列セグメントを 2 つ含むセグメント キーで、この 2 つのセグメントには、16 進数で 20（スペース）のヌル値が指定されています。キー 0 では、照合順序 upper.alt が使用されます。

キー 1 は、重複不可能で変更可能な数値型のセグメント化されていないキーです。これは、降順でソートされます。

drop コマンドは、ファイルからインデックスを削除し、それ以降のキー番号から 1 を引くことによって、残りのインデックスのキー番号を調整します。キーの番号を調整しない場合は、削除に指定したキー番号に 128 を加算します。この調整は、6.0 以降のファイルでのみ使用可能です。

以下の例では、course.mkd に 3 つのキーが存在します。ファイルの元のキーは、それぞれの番号が 0、1、2 となっています。

最初の例では、butil -drop コマンドで、course.mkd からキー番号 1 を削除し、残りのキー番号をそれぞれ 0 と 1 に調整します。

以下の例では、butil –drop コマンドでキー番号 1 を削除し、キー番号の調整は行いません。キー番号は、それぞれ 0 と 2 のままになります。

index コマンドは、既存ファイルでキーとして指定されていないフィールドに基づき、既存 MicroKernel ファイルの外部インデックス ファイルを構築します。index コマンドを実行する前に、新しいキー属性を指定するディスクリプション ファイルを作成します。ディスクリプション ファイルの詳細については、『Advanced Operations Guide』の「ディスクリプション ファイル」を参照してください。

新規ファイルのレコードは、以下から構成されます。

index コマンドは、外部インデックス ファイルを作成し、インデックスが設定されたレコードの数を表示します。外部インデックス ファイルを使用して、データ ファイルのレコードを読み込む場合は、Save コマンドを使用します。

以下のコマンドは、データ ファイル course.mkd を使用し、外部インデックス ファイル newcrs.idx を作成します。course.mkd ファイルには、オーナー ネームは必要ありません。新しいキーの定義を含むディスクリプション ファイルは、newcrs.des という名前です。

setowner コマンドは、データ ファイルのオーナー ネームを設定します。

以下の例では、course.mkd データ ファイルの短いネームのオーナーを作成します。オーナー ネーム Sandy に制限レベル 1 を設定します。

以下の例では、billing.mkd データ ファイル用の長いオーナー ネームを作成し、そのオーナー ネームとファイルを暗号化し、すべてのアクセス モードを制限します。

sindex コマンドは、既存 MicroKernel ファイルに追加インデックスを作成します。デフォルトでは、新規インデックスのキー番号は、データ ファイルでそれまで最大だったキー番号より 1 つ大きな番号になりますが、キー番号を指定することも可能です。ただし、drop コマンドでインデックスを削除し、残りキー番号の調整を行わなかった場合は未使用のキー番号が存在するため、例外が発生します。この場合は、新しいインデックスに最初の未使用番号が割り当てられます。

キー番号オプションを使用することにより、新規インデックスのキー番号を指定できます。指定するキー番号は、ファイルで使用されていない有効なキー番号でなければなりません。無効なキー番号を指定した場合は、ステータス コード 6 が返されます。

このコマンドで SYSKEY または SYSKEY2 オプションを使用しない場合は、sindex コマンドを使用する前に、インデックスのキー仕様を定義するディスクリプション ファイルを作成する必要があります。詳細については、『Advanced Operations Guide』の「ディスクリプション ファイル」を参照してください。

以下の例では、course.mkd にインデックスを追加します。ディスクリプション ファイルの名前は、newidx.des です。

以下の例では、システム定義キーが削除された course.mkd にシステム定義キーを追加します。

butil では、複数のコマンド（Clone、Recover、Load）を使用してデータ ファイルの未使用スペースを削除し、ファイル サイズを縮小することができます。

パフォーマンスを向上させるために、butil で cache コマンドと purge コマンドを使用してファイルのページ キャッシュを管理することができます。

butil -cache および butil -purge コマンドがクライアント キャッシュ エンジンやレポート エンジンから実行される場合、そのコマンド アクションが適用されるのはローカル キャッシュにあるファイルのみです。

ファイルがクライアント キャッシュに残るようにするには、以下のいずれかの状況になっていなければなりません。

クライアント キャッシュ エンジンがアプリケーションとしてインストールされている場合は、シャットダウンしてクライアントがすべてのファイルを閉じた直後にキャッシュを空にします。これは、サービスとしてインストールされているクライアント キャッシュ エンジンやレポート エンジンの場合には問題になりません。

cache コマンドは、ファイルのページをキャッシュへ事前ロードします。ただし、ファイルが完全にキャッシュされているか、またはキャッシュがいっぱいの場合にはロードされません（コマンド プロンプに戻ります）。

purge コマンドは、ファイルの不要なキャッシュ ページをすべて消去します。ファイルがオープン ハンドルを持つ場合は消去されません（ただちにコマンド プロンプトに戻ります）。

このトピックでは、stat を使用してデータ ファイルの特性や統計情報に関するレポートを生成する方法を説明します。

stat コマンドは、定義されているデータ ファイルの特性、およびファイルの内容に関する情報を含むレポートを作成します。stat コマンドは、Create Index オペレーションと Create オペレーションによってファイルに定義されたキーの区別を付けません。

butil -stat ステートメントは、ファイル統計情報とエラー メッセージの出力として 2 つの形式を提供します。デフォルトはテキスト出力ですが、/json オプションを使用すれば同じ情報が JSON 形式で返されます。

次の例は、これらのオプションを示しています。

次の例は、patients.dta ファイルの情報をテキストとして表示します。

以下の情報が返ります。

この例では、patients.dta のファイル バージョンが 8.0 であることを表しており、これがファイル形式を読むことができる Btrieve の一番古いバージョンであることを示します。ファイルには、2048 バイトのページ サイズが指定されており、プリアロケート ページはありません。これは、キー オンリー ファイルでも拡張ファイルでもありません。

このファイルには 16 件のレコードが挿入されています。また、104 バイトのレコード長が定義されており、レコード圧縮は使用せず、可変長レコードも許可されていません。

このファイルには、利用可能なリンク重複キーはありません。インデックス バランスも使用しません。キー 1 を使用したログが実行され、ファイルには、システム定義のデータも存在しません。また、4 つのキー セグメントから構成される 3 つのキーが存在します。

統計情報レポートには、特定のキーに関する情報も表示されます。たとえば、キー 0 は2 つのセグメントから構成され、重複可能、変更可能であることがレポートに表示されます。このほか、以下も表示されます。

キー 1 は、このファイルのログに使用されるキーです。これは 1 つのセグメントで構成されます。ポジション 1 から始まり、長さが 6 バイト、重複不可、変更可能、そして string 型として保存されます。16 個の重複しないキー値が、このキーに挿入されています。このキーでは、オルタネート コレーティング シーケンス ファイル upper.alt が使用されます。

キー 2 は、1 つのセグメントで構成されます。ポジション 83 から始まり、長さが 10 バイト、重複可能、変更可能、そして string 型として保存されます。7 個の重複しないキー値が、このキーに挿入されています。このキーでは、オルタネート コレーティング シーケンス ファイル upper.alt が使用されます。

次の例は、patients.dta ファイルの情報を JSON として表示します。

テキスト形式のファイル統計情報に示されている、デフォルトの -stat オプションと同じ内容が返ります。

次の例は、エラー メッセージをテキストとして表示します。

以下のエラーが返ります。

次の例は、エラー メッセージを JSON として表示します。

テキスト形式のエラー メッセージに示されている、デフォルトの -stat オプションと同じ内容が返ります。

ファイルにシステム データ v2 が含まれている場合は、次の 2 つの追加エントリが出力に含まれます。

ファイル形式のバージョンを求められたら、データベース エンジンは指定したファイルを読むことのできる最も古いエンジンのバージョンを指定します。たとえば、5.x 形式で作成されたファイルがある場合でも、4.x または 5.x の機能を使用していないのであれば、レポートにはバージョン 3.x ファイルとして出力されます。6.x 形式で始めるには、ファイル自体にバージョン スタンプを含める必要があります。6.x より前のバージョンの場合、ファイル形式のバージョンを調べる唯一の方法は、ファイルで使用されている機能を調べることでした。これは、ファイル バージョンごとに利用できる機能に違いがあり、新しいファイル バージョンにはそれ以前のバージョンでは利用できない機能があるからです。

バージョン 5.x およびそれ以前のファイルについては、使用されている機能と、それによって特定できるファイル形式のバージョンを次の表に示します。

このセクションでは、ver コマンドを使用した、MicroKernel エンジンのバージョンの表示に関して説明します。

ver コマンドは、MicroKernel エンジンおよびリクエスター（アクセス モジュール）の両方のバージョン番号を表示します。

ver コマンドを実行した場合、以下のようなメッセージが表示されます。

stop コマンドは、MicroKernel エンジンおよびリクエスターをアンロードします。

Continuous オペレーションに関連するコマンド startbu および endbu については、『Advanced Operations Guide』の「ログ、バックアップおよび復元」で説明しています。

Maintenance ツール（GUI またはコマンド ラインの butil）は、アーカイブ ログ ファイルをデータ ファイルにロール フォワードする手段を提供します。『Advanced Operations Guide』の「ログ、バックアップおよび復元」も参照してください。

butil rollfwd コマンドは、最後のバックアップからシステム エラーが発生する間に行った、データ ファイルへの変更を回復します。システム エラーが発生した場合は、データ ファイルのバックアップ コピーを復元した後、butil rollfwd コマンドを使用し、ログに保存されているすべての変更を復元したデータ ファイルに適用します。バックアップからデータ ファイルを復元しない限り、このコマンドを使用しないでください。

また、rollfwd コマンドを使用し、ログ オペレーションの出力ファイルを作成することも可能です。rollfwd コマンドでは、ロール フォワード前、またはロール フォワードと同時に出力ファイルを作成できます。

単一のファイルをロール フォワードすることもできますし、ボリューム上のすべてのデータ ファイル、ドライブ上のすべてのデータ ファイル、もしくは、ファイル、ボリュームおよび/またはドライブのリストをロール フォワードすることもできます。

このトピックでは、ロール フォワードをコマンド ラインで使用する構文を説明します。

例 A 次の例は、class.mkd ファイルに、デフォルトのアーカイブ ログおよびログ ロケーションから変更を回復します。

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

例 B この例では変更を回復し、それらを以下のオプションを使用して d:\ ボリュームのすべてのファイルに出力します。

例 C 以下の例では、ロール フォワードは実行されず、以下のダンプ オプションに従って、files.txt にリストされているファイルへの変更が出力されます。