ディスクリプションファイル

ディスクリプションファイルは、Maintenance ツールがデータファイルやインデックスの作成に使用するファイルスペックとキースペックの記述を含む ASCII テキストファイルです。作成したファイルの情報を保存するための媒体としてディスクリプションファイルを使用することもできます。ディスクリプションファイルは、リレーショナルエンジンで使用されるデータ辞書ファイル（DDF）とは異なります。

ディスクリプションファイルには 1 つ以上の要素が含まれます。1 つの要素は、キーワード、等号（=）、それに値がスペースなしで続く形式で構成されます。ディスクリプションファイルの各要素は、データファイルまたはキースペックの特性に対応しています。

メモ：ディスクリプションファイルを使用する前に、Btrieve の基本について熟知しておく必要があります。これらのトピックスの詳細については、『Zen Programmer's Guide』を参照してください。

この付録では以下の項目について説明します。

•

•

•

ディスクリプションファイルを作成する際は、以下の規則に従います。

•

要素は、大文字または小文字のいずれかで入力する。

•

要素を区切る場合は、以下の例のように、区切り文字（スペース、タブ、またはキャリッジリターン/ラインフィード）を使用する。

record=4000

key=24

•

ディスクリプションファイルの要素を適切な順序で指定する。ディスクリプションファイルの要素で示す表に要素の適切な順序が示されています。

•

要素の依存関係は、すべて指定する。たとえば、ディスクリプションファイルで nullkey=allsegs を指定した場合は、value= という要素の値も指定します。

•

キーには、キー数要素で指定した数と同じ数のキーを定義する。たとえば、key=12 を指定した場合は、ディスクリプションファイルでも 12 個のキーを定義します。

•

キーに複数のセグメントがある場合は、各キーセグメントに以下の要素を定義する。

•

•

•

•

•

各セグメントの降順ソート要素は、省略可能です。

•

ファイル中のキーで ACS を使用している場合は、ACS ファイル名または ISR テーブル名を指定する。この情報は、キーの最後の要素（現在のキーのみに適用）またはディスクリプションファイルの最後の要素（データファイル全体に適用）として含めることができます。

•

1 つのキーに対して指定できる ACS は 1 つのみで、ACS ファイル名または ISR テーブル名も指定します。同一ファイル内の異なるキーには、異なる形式の照合順序を使用できます。たとえば、キー 0 に ACS ファイル名、キー 1 に ISR テーブル名を使用できます。

•

同一キーの異なるセグメントに、異なる照合順序を使用することはできません。

•

ディスクリプションファイルの最後に ACS を指定した場合は、その ACS がデフォルトとして使用されます。たとえば、キーに alternate=y を指定し、そのキーに ACS ファイル名または ISR テーブル名を指定しない場合、データベースエンジンでは、ファイルの最後に指定されている ACS ファイル名または ISR テーブル名を使用します。

•

新しいキーを作成する際に alternate=y を指定し、ACS ファイル名または ISR テーブル名を指定しない場合、データベースエンジンでキーは作成されません。

•

ディスクリプションファイルの要素がオプションの場合は、それを省略することができる。

•

ディスクリプションファイルには、書式設定文字列を使用しない。一部のワードプロセッサでは、テキストファイルに書式設定文字列が埋め込まれます。

ディスクリプションファイルの例

このセクションにあるディスクリプションファイルのサンプルは、データファイルの説明です。このデータファイルのページサイズは 512 バイトで、キーは 2 つです。レコードの固定長部分は 98 バイトです。ファイルで可変長レコードは使用可能ですが、ブランクトランケーションは使用できません。

ファイルはレコード圧縮を使用します。また、可変長部割り当てテーブル（VAT）を許可し、空きスペーススレッショルドは 20 % に設定されています。MicroKernel エンジンは、ファイルを作成する際に 100 ページ、つまり 51,200 バイトをプリアロケートします。ファイルには、キー 0 およびキー 1 の 2 つがあり、キー 0 には 2 つのセグメントがあります。

次の図では、同一の ACS ファイル名（upper.alt）が両方のキーで使用されています。