Btrieve オペレーションのテスト

上級者リファレンス : Advanced Operations Guide : Btrieve オペレーションのテスト

このページをシェアする

Btrieve オペレーションのテスト

Function Executor で Btrieve オペレーション実行する方法

以下のトピックでは Function Executor ツールの使用に関して説明します。

•Function Executor の概念

•Function Executor のグラフィカルユーザーインターフェイス

•Function Executor での作業

Function Executor の概念

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

•概要

•Function Executor でできること

•Function Executor の機能

•Function Executor の自動モード

•詳細情報を入手するには

概要

Function Executor は Windows 上で動作します。この対話型ツールを使用すると、Btrieve オペレーションがどのように動作するかを確認することができます。Btrieve オペレーションは、MicroKernel エンジンオペレーションと同じです。

また、Btrieve オペレーションを一度に 1 つずつ実行できるため、アプリケーション開発者は Function Executor を使って、Btrieve アプリケーションのオペレーションをシミュレートすることができます。このシミュレーションは、アプリケーションの残りの部分のデータベース呼び出しから分離しているので、プログラムのテストおよびデバッグに役立ちます。

Function Executor は、本来アプリケーション開発者向けのツールです。この章では、Btrieve オペレーションの基礎知識があることを前提に説明を進めます。Btrieve オペレーションの詳細については、開発者リファレンスの『Btrieve API Guide』を参照してください。

Function Executor でできること

•Btrieve オペレーションを実行しながらメモリ構造の内容を監視することができます。

•一連の Btrieve オペレーションをキャプチャして履歴ファイルとして保存し、後で再生することができます。

•Btrieve クライアント、ローカルエンジンおよびリモートエンジンのバージョンを表示します。

•データファイルの Btrieve 特性を表示し、これらをテンプレート（ディスクリプションファイル）として保存したり、これらの特性に基づいて新しいファイルを作成したりすることができます。詳細については、ファイル統計情報を参照してください。

Function Executor の機能

Function Executor の機能は以下のとおりです。

エディターステータスバー

ステータスバーには以下の要素があります。

	開いているファイルのウィンドウの下部にあるエディターウィンドウのステータスバーに最新/現在のステータスコードが表示され、最新のステータスがゼロ以外の場合には赤色で表示されます。
	ステータスコードにマウスカーソルを移動すると、そのステータスについての説明と、原因となったオペレーションが表示されます。これらのステータスコードのヘルプ全体を表示するには、赤色で表示されている部分をクリックします。詳細については、ステータスコードのヘルプを見るにはを参照してください。
	カーソルが Function Executor メインウィンドウの入力領域にあるときには、ステータスバーにはバッファー内でのオフセットが表示されます。つまり、現在の位置のバイトを 16 進数、10 進数、ASCII 値で表した値が表示されます。
	キューに複数の項目がある場合には、オペレーションがいくつ実行されたのかもステータスバーに表示されます。通常、1 / 1 と表示されますが、複数のオペレーションを実行している場合には実行されるオペレーションの数が表示されます。
	トランザクションに入ると、その状態もステータスバーに表示されます。

統計情報

［ファイル統計情報］アイコンをクリックすると、現在開いているファイルについての統計情報を一覧表示したダイアログボックスが表示されます。これらの統計情報をテキストファイルに出力したり、butil -create コマンドで使用できるディスクリプションファイルに保存することができます。また、同じ特性を持つ空のファイルを新規作成することもできます。

Get および GetExt

［Get］メニューから、テーブル内にある先頭レコード、次レコード、前レコード、末尾レコードを取得することができます。［GetExt］メニューには、［Goto Percent（パーセンテージによるレコードの取得）］、［Get Position（物理位置の取得）］、［Find Percent（レコード位置のパーセンテージを取得）］の各コマンドがあります。

［Get］コマンドと［GetExt］コマンドは、メニューバーとツールバーから使用できます。ツールバーには、［Step］（物理的）と［Get］（論理的）があり、ファイルの自然の順序で（物理的）、または特定の順序で（論理的）移動できます。

［Goto Percent（パーセンテージによるレコードの取得）］では、ファイルの物理レイアウト内での特定の地点に移動するか、あるいはそのファイル内に定義されているキーを定めて、任意のキーパスをたどっていくかどうかの選択ができます。［ロック］グループボックスのオプションボタンを使用して、ロックバイアスを設定することもできます。

［Find Percent（レコード位置のパーセンテージを取得）］は、［Goto Percent（パーセンテージによるレコードの取得）］の逆です。ファイル内を論理的に移動しているか、物理的に移動しているかによって、データ内での位置を示します。

トランザクションツールバー

トランザクションツールバーを使用すると、トランザクションの開始、終了、中止を行うことができます。Transaction API のすべてをこのツールバーで設定することができ、オペレーションはすぐに実行されます。トランザクションのステータスは、そのクライアント ID 用に開いているすべてのファイルに影響するため、メインウィンドウのステータスバーにも表示されます。

ログインダイアログ

ログインダイアログボックスを使用すると、GUI インターフェイスを介して Btrieve ログイン操作を実行することができます。詳細については、データベースセキュリティとその設定に関するトピックを参照してください。

履歴ログ

Function Executor ツールを使用してオペレーションを実行すると、これらは履歴ログに記録されます。このログを使用して、ログに含まれるオペレーションを実行したり、履歴をファイルとして保存し後で再読み込みして同じ手順を行うことができます。

履歴ログの詳細については以下のトピックを参照してください。

•履歴

•履歴の作業

任意のデータ型での表示

ファイルが開いているとき、バッファー内の任意の場所を右クリックし、［表示形式］をクリックします。ダイアログボックスが表示され、選択したバッファー位置のバイト数を任意のデータ型で表示できます。

表 55 に Function Executor で使用できるコントロールを示します。

表 55 Function Executor のコントロール
コントロール	説明
履歴	コマンドの繰り返しができます。
作成	新規ファイルを作成できます。
ファイル統計情報	BSTAT 関数の情報を示します。この統計情報は印刷できます。
MDI	Multiple Document Interface によって、複数のファイルを開くことができます。
リセット	クライアント ID をリセット
ストップ	Btrieve の停止
バージョン	Btrieve バージョン情報

Function Executor の自動モード

開いているファイルごとに（アプリケーションウィンドウを参照）Btrieve オペレーションを実行する際に Function Executor を使用するかどうかを選択することができます。Function Executor を使用する方法としない方法で設定を変更する必要はありません。自動モードと手動モードのどちらを使用するかは、どの GUI コントロールを使用するかによって決まります。

図 9 自動モードと手動モードのコントロール

メモ：メニュー（アプリケーションウィンドウを参照）での選択も自動モードの一部として行われます。

自動モード領域のボタンをクリックすると、ツールは以下のような支援を行います。

•データバッファーとデータ長は、自動的にステータスコード 22 を防ぐように設定されます。

•情報は操作に応じて適切に要求されます。

詳細情報を入手するには

Function Executor はプログラム開発者にとって有益なツールですが、Btrieve の実際的な基礎知識があることを前提にしています。このツールのすべての機能を理解するには、以下のトピックを参照してください。

•『Zen Programmer's Guide』の「MicroKernel エンジンの基礎」

•『Btrieve API Guide』

•本ドキュメントのセキュリティに関するさまざまなトピック

Function Executor のグラフィカルユーザーインターフェイス

このトピックでは、Function Executor のグラフィカルユーザーインターフェイス（GUI）のオブジェクトについて説明します。

•Btrieve ファイルの新規作成用ダイアログ

•トランザクションツールバー

•ファイル統計情報

•履歴

アプリケーションウィンドウ

下の表は次の図のウィンドウコンポーネントの説明です。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 56 Function Executor アプリケーションウィンドウ
GUI のオブジェクト	説明	関連情報
［ファイル］メニュー	以下のコマンドおよび Btrieve オペレーションが実行できます。 •Login および Logout •Open および Close •New •Print Setup •Set Owner Name および Clear Owner Name •Continuous オペレーションの開始または終了 •Reset、Stop および Exit	オペレーション作業の実行ファイルを開く作業
［Get］メニュー	以下の Btrieve オペレーションが実行できます。 •Get First および Get Next •Get Previous および Get Last •Get Greater Than および Get Greater or Equal •Get Less および Get Less or Equal	オペレーション作業の実行
［GetExt］メニュー	以下の Btrieve オペレーションが実行できます。 •Goto Percent •Get Position •Find Percent	オペレーション作業の実行
［Step］メニュー	以下の Btrieve オペレーションが実行できます。 •Step First および Step Next •Step Previous および Step Last	オペレーション作業の実行
［Update］メニュー	以下の Btrieve オペレーションが実行できます。 •Insert、Update および Delete このメニューを使用してロックを解除することもできます。	オペレーション作業の実行
［表示］メニュー	GUI 要素を表示することができます。 •ツールバー（メインおよびトランザクション） •履歴ウィンドウ •ファイル統計情報ウィンドウ •Btrieve Version オペレーションを使用したエンジンのバージョン	履歴の作業
［ツール］メニュー	以下の Btrieve オペレーションが実行できます。 •Get Directory および Set Directory
［ウィンドウ］メニュー	ウィンドウ操作が実行できます。 •［ウィンドウを重ねて表示］および［ウィンドウを並べて表示］ •開いているウィンドウの一覧から選択
［ヘルプ］メニュー	このツールのヘルプリソースを一覧から選択することができます。	ステータスコードのヘルプを見るには
［開く］ボタン	ダイアログボックスを表示し、開く Btrieve ファイルを選択します。	ファイルを開く作業
［新規作成］ボタン	ダイアログボックスを表示し、新規 Btrieve ファイルを作成することができます。	Btrieve ファイルを作成する作業
［リセット］ボタン	現在のクライアント接続をリセットし（Btrieve オペレーション 28）、そのクライアント ID で開いているすべてのファイルを閉じます。
［停止］ボタン	トランザクションオペレーション（Btrieve オペレーション 25）を終了させ、開いているすべてのファイルを閉じます。
統計情報	現在開いているファイルの統計情報を一覧表示するダイアログボックスを表示します。これらの統計情報をテキストファイルに出力したり、BUTIL -CREATE で使用できるディスクリプションファイルに保存することができます。
［バージョン］ボタン	実行中の Zen のバージョン情報を（Btrieve オペレーション 26 を使用して）表示します。開かれているファイルがない場合には、リクエスター DLL とローカル MicroKernel エンジンについての情報が表示されます。リモートサーバーでファイルを開いている場合、サーバーとリクエスター DLL についての情報が表示されます。
ヘルプの表示	ゼロ以外のステータスコードを受け取ったときにポップアップダイアログボックスを表示するかしないかを切り替えます。
履歴の表示	履歴ウィンドウを表示するかしないかを切り替えます。	履歴ウィンドウを表示するには履歴履歴ログ
オペレーションカウント	現在のオペレーション数を示します。繰り返しの値に 2 以上を設定したときに使用されます。	オペレーション作業の実行
トランザクションの状態	トランザクションの現在の状態を示します。以下のいずれかになります。 •空白（トランザクションが 1 つも有効でない場合） •並行（Concurrent） •排他（Exclusive）	オペレーション作業の実行トランザクションツールバー

メインウィンドウ

すべての開いているファイルについて、メインウィンドウが表示されます。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 57 Function Executor メインウィンドウ（オープンファイル用）
GUI のオブジェクト	説明	関連情報
タイトルバー	開いているデータファイルの絶対パスを一覧表示します。	Function Executor でデータファイルを開くには
データバッファー	データの値を指定します。読み取りや書き込みオペレーションでは、Data Buffer にレコードが含まれています。ほかのオペレーションには、データベースエンジンでオペレーションの処理に必要なファイルスペック、フィルター条件、その他の情報が Data Buffer に含まれています。このコントロールは Data Buffer パラメーターに対応するものです。
キーバッファー	Btrieve オペレーションを実行するデータファイルのパスを指定します。
Step と Get	Step および Get オペレーションを切り替えます。
Get/Step First	Get Next または Step Next オペレーションを実行します。	オペレーション作業の実行
Get/Step Prev	Get Previous または Step Previous オペレーションを実行します。	オペレーション作業の実行
Get/Step Next	Get Next または Step Next オペレーションを実行します。	オペレーション作業の実行
Get/Step Last	Get Last または Step Last オペレーションを実行します。	オペレーション作業の実行
Get Equal	Get Equal オペレーションを実行します。	オペレーション作業の実行
Get Less Than	Get Less Than オペレーションを実行します。	オペレーション作業の実行
Get Greater Than	Get Greater Than オペレーションを実行します。	オペレーション作業の実行
Get Less Than or Equal	Get Less Than または Get Equal Than オペレーションを実行します。	オペレーション作業の実行
Get Greater Than or Equal	Get Greater Than または Get Equal Than オペレーションを実行します。	オペレーション作業の実行
Get/Find Percent	Get Percent または Find Percent オペレーションを実行します。	オペレーション作業の実行
Insert	Insert オペレーションを実行します。	オペレーション作業の実行
Update	Update オペレーションを実行します。	オペレーション作業の実行
Delete	Delete オペレーションを実行します。	オペレーション作業の実行
Cancel	最後に行った変更をキャンセルします。
Unlock	すべてのロックを解除します。
Set Bookmark または Goto Bookmark	前もって定義しておいたブックマークに設定または位置付けます。
キー番号	ほとんどの Get オペレーションで、現在のオペレーションが従うことになるキー番号またはインデックスパスを指定します。ほかのオペレーションには、ファイルオープンモード、暗号化、論理ディスクドライブなどの情報を指定するものもあります。このコントロールは Key Number パラメーターに対応するものです。
キーオンリー	データではなくキーのみを取得することを指定します。
繰り返し	オペレーションを指定した回数だけ繰り返します。
ロック	現在のオペレーションで行いたいロック動作を指定します。
オペレーションコード	現在のオペレーションコードとそのバイアス（ある場合）を示します。デフォルト設定は、0 です。Btrieve オペレーションコードに精通している場合は、目的のコードを入力することができます。慣れていなければ、［リスト］ボックスを使用してオペレーションを指定します。このコントロールは、オペレーションコードパラメーターに対応するものです。	オペレーション作業の実行
［実行］ボタン	現在指定されているオペレーションを実行します。	オペレーション作業の実行
オペレーションリスト	Btrieve オペレーションとそのコードをリストします。デフォルトは Open（0）です。実行するオペレーションの頭文字を入力すれば、リスト内ですぐに移動ができます。	オペレーション作業の実行
データ長	データバッファーの長さ（バイト単位）を指定します。デフォルト値は 1024 です。データバッファーを必要とする各オペレーションでは、バッファー長を必ず指定してください。多くのオペレーションでは、データベースエンジンにより Data Length に値が返されます。一般には、オペレーションの実行前に、Data Length を必ず指定してください。このコントロールは Data Buffer Length パラメーターに対応するものです。	オペレーション作業の実行
ステータスコードインジケーター	データベースエンジンで返された数値のステータスコードと、Btrieve オペレーションの結果を示す短いメッセージが表示されます。これらのステータスコードやメッセージについての詳細は、『Status Codes and Messages』マニュアルを参照してください。	ステータスコードのヘルプを見るには
Continuous オペレーションインジケーター	ファイルが Continuous オペレーションモード（オペレーション 42）にある場合、ファイルウィンドウの最下行に以下を表示します。	Continuous オペレーションの使用

ログインおよびログアウト

ログインダイアログボックスとログアウトダイアログボックスでは、データベースエンジンに対する Btrieve のログインおよびログアウトオペレーションを実行することができます。画像の領域をクリックするとその詳細が表示されます。

図 10 ログインダイアログ

図 11 ログアウトダイアログ

表 58 Function Executor ログインおよびログアウトダイアログ
GUI のオブジェクト	説明
サーバー	ログインまたはログアウトしたいデータベースが存在するサーバーを指定します。Linux および macOS オペレーティングシステム上のデータベースにアクセスするにはサーバー名が必要なので注意してください。『Zen Programmer's Guide』のデータベース URI も参照してください。
データベース	認証を求めるサーバー上のデータベースを指定します。
ユーザー名	データベースに対して認証を求めるユーザーの名前です。
パスワード	ユーザー名に対するパスワードです。
クライアント ID	このログインまたはログアウトを特定のクライアント ID にのみ適用する場合は、［使用］をクリックして範囲を指定します。それ以外の場合は、そのままにしておきます。『Btrieve API Guide』のクライアント ID を参照してください。
URI 文字列	情報をフォームに入力すると、選択した結果の URI がこの領域に表示されます。

［ファイルのオープン］ダイアログ

このダイアログを使用すると、ファイルを開くことができます。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 59 Function Executor ファイルのオープンダイアログ
GUI のオブジェクト	説明	関連情報
ファイル名	開くファイルの場所と名前を設定します。	ファイルを開く作業
オーナーネーム	Btrieve ファイルのパスワードとして機能します。このパスワードは Btrieve ファイルへのアクセスに必要です。短いオーナーネームは半角 8 文字までの範囲で指定できます。長いオーナーネームの長さは、ファイル形式によって異なります。詳細については、オーナーネームを参照してください。	ファイルを開く作業
モード	ファイルを開くときの状態を設定します。この状態に基づき、データベースエンジンは開くファイルに適用する条件を識別します。たとえば、ファイルの読み取りは可能だが更新はできない（リードオンリー）という条件が可能です。	ファイルを開く作業モードの説明については、『Btrieve API Guide』を参照してください。
クライアント ID	このログインを特定のクライアント ID にのみ適用する場合は、［使用］をクリックして範囲を設定します。それ以外の場合は、そのままにしておきます。	ファイルを開く作業
共有	データベースエンジンは、［共有］オプションを無視します。［共有］オプションは、このエンジンのレガシーバージョンである Btrieve 6.15 のみに適用されます。	ファイルを開く作業

Btrieve ファイルの作成

このダイアログボックスを使用すると、既に開いているファイルを基に、Btrieve ファイルを作成することができます。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 60 Function Executor ファイルの作成ダイアログ
GUI のオブジェクト	説明	関連情報
ファイル名	作成するファイルの場所と名前を設定します。	Btrieve ファイルを作成する作業
オーナーネーム	Btrieve ファイルのパスワードとして機能します。このパスワードは Btrieve ファイルへのアクセスに必要です。短いオーナーネームは半角 8 文字までの範囲で指定できます。長いオーナーネームの長さは、ファイル形式によって異なります。詳細については、オーナーネームを参照してください。	Btrieve ファイルを作成する作業
モード	ファイルを開くときの状態を設定します。この状態に基づき、データベースエンジンは開くファイルに適用する条件を識別します。たとえば、ファイルの読み取りは可能だが更新はできない（リードオンリー）という条件が可能です。	Btrieve ファイルを作成する作業モードの説明については、『Btrieve API Guide』のオープンモードを参照してください。
クライアント ID	このログインを特定のクライアント ID にのみ適用する場合は、［使用］をクリックして範囲を設定します。それ以外の場合は、そのままにしておきます。	Btrieve ファイルを作成する作業
共有	データベースエンジンは、［共有］オプションを無視します。［共有］オプションは、データベースエンジンのレガシーバージョンである Btrieve 6.15 のみに適用されます。

Btrieve ファイルの新規作成用ダイアログ

このダイアログボックスを使用すると、作成されているファイルに、さらに別の属性を指定することができます。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 61 Function Executor ファイルの作成ダイアログ（高度）
GUI のオブジェクト	説明	関連情報
［キー］および［セグメント］コマンド	キーの追加と削除や、キーセグメントの追加、挿入、削除が行えます。	Btrieve ファイルを作成する作業
ファイル仕様	ファイルの仕様の表示、およびその編集が行えます。	Btrieve ファイルを作成する作業レコードおよびページ圧縮
統計情報	ファイルに関する情報を提供します。読み取り専用です。	Btrieve ファイルを作成する作業
キーとセグメントの行列	ファイルのキーとセグメントの開始位置、長さ、属性およびデータ型を表示します。行をクリックすると、下方のキーとセグメントの各ブロックで情報が表示されます。必要であれば、この情報は変更することもできます。	Btrieve ファイルを作成する作業
キー	キーの仕様の表示、およびその編集が行えます。	Btrieve ファイルを作成する作業
セグメント	セグメントの仕様の表示、およびその編集が行えます。	Btrieve ファイルを作成する作業
各種コマンドボタン	データファイルやディスクリプションの作成、あるいはダイアログボックスで行った編集をキャンセルすることができます。	Btrieve ファイルを作成する作業

トランザクションツールバー

ファイルが開いているとき、［表示］>［ツールバー］>［トランザクション］を選択すると、トランザクションツールバーを表示できます。このツールバーを使用して、トランザクションを手動で制御することができます。次の画像の領域をクリックすると、このツールバーで行えることが表示されます。

表 62 Function Executor トランザクションダイアログ
GUI のオブジェクト	説明	関連情報
メインアプリケーションウィンドウ	プログラムの主な機能です。	アプリケーションウィンドウ
トランザクションの種類	排他的トランザクションまたは並行トランザクションのどちらを使用するかを指定します。
ロック情報	トランザクションで使用するロックの種類を指定します。
［トランザクションの開始］ボタン	トランザクションを開始します。
［トランザクションのコミット］ボタン	アクティブなトランザクションをコミットします。
［トランザクションの中止］ボタン	アクティブなトランザクションを中止し、行われた変更をロールバックします。
ファイル領域	この領域には開いているファイルが 1 つ以上含まれます。	メインウィンドウ
トランザクションインジケーター	現在トランザクション内にあるかどうかを示します。ここには "並行" または "排他" と表示されます。

ファイル統計情報

ファイルが開いているとき、［表示］>［ファイル統計情報］を選択する、ツールバーの［ファイル統計情報］アイコンをクリックする、または Ctrl+S キーを押すと、ファイル統計情報ウィンドウを表示できます。このウィンドウでは、ファイルの統計情報を見ることができます。次の画像の領域をクリックすると、このウィンドウで行えることが表示されます。

表 63 Function Executor ファイル統計情報ダイアログ
GUI のオブジェクト	説明
ファイル情報	ファイルの統計情報を表示します。
フラグ	このファイルに設定されているフラグを表示することができます。ダイアログボックス内の一覧で、設定されているすべてのフラグの隣にはチェックマークが付きます。
キー	このファイルに定義されているキーを表示することができます。
キーの凡例	1 文字の値でこのファイルのキー属性を示します。 •D = DUP（重複可能） •M = MOD（変更可能） •R = REPEAT_DUPS_KEY（繰り返し重複キー） •A= NUL（全セグメントヌルキー） •L = MANUAL_KEY（一部セグメントヌルキー） •< = DESC_KEY（キー値を表します） •I = NOCASE_KEY（大文字小文字無視キー）『Zen Programmer's Guide』のキー属性も参照してください。
［印刷］ボタン	ファイル統計情報を印刷することができます。［ファイル］メニューを使用してプリンターを設定します。
［保存］ボタン	現在のファイル統計情報をディスクリプションファイルに保存することができます。このディスクリプションファイルを使用して、後で同じ属性を持つファイルを新規作成することができます。
［ファイルの新規作成］ボタン	これらのファイル統計情報に基づいて新規ファイルを作成することができます。

履歴

このダイアログボックスを使用すると、これまでに実行したすべてのオペレーションを見ることができます。スクリーンショット上のそれぞれの領域をクリックするとその詳細が表示されます。

表 64 Function Executor 履歴ダイアログ
GUI のオブジェクト	説明	関連情報
［ファイル］メニュー	以下の操作が実行できます。 •履歴ファイルのインポート •履歴ファイルのエクスポート •履歴ウィンドウを閉じる
［設定］メニュー	履歴ウィンドウの表示属性を指定することができます。 •終了時に保存 - 履歴ウィンドウで行ったカスタマイズをほかのセッションでも使用できるように保存するかどうかを指定します。 •デフォルト - 履歴ウィンドウをデフォルトの設定にリセットします。指定した設定はすべて取り除かれます。 •ドッキング - 履歴ウィンドウの状態で、分離したウィンドウまたはアプリケーションウィンドウと一体化した状態とを切り替えます。 •手前に表示 - 履歴ウィンドウの状態を、フォーカスを失わない状態と失う状態の間で切り替えます。	•履歴ウィンドウのドッキング状態を切り替えるには •履歴ウィンドウの常に前面に表示状態を切り替えるには •履歴ウィンドウをデフォルトの設定にリセットするには
［実行］コマンド	［履歴の再生設定］ウィンドウをロードします。
オペレーションの一覧	最近実行したオペレーションを一覧表示します。各オペレーションと共に以下の情報がログに記録されます。 •ファイル ID •［オペコード名］チェックボックスの状態により、オペレーション名またはオペレーション番号。 •そのオペレーションが実行されたときのステータスコード。 •そのオペレーションが実行された回数。 •そのオペレーションで設定されたキー番号。 •キーバッファーの内容。 •データバッファーの内容。	•履歴の作業 •履歴
ロギング	履歴一覧に将来のオペレーションを含めるか含めないかを切り替えます。
オペコード名	オペレーション列に表示するオペレーションコード名（B_OPEN など）とオペレーションコード番号（B_OPEN に対する０）を切り替えます。

Function Executor での作業

Function Executor での作業は以下のカテゴリにグループ化されています。

•Function Executor での作業の開始

Function Executor での作業の開始

►Function Executor を起動するには

1 オペレーティングシステムの［スタート］メニューまたはアプリ画面から、あるいは Zen Control Center の［ツール］メニューから Function Executor にアクセスします。

2 メインウィンドウが表示されます。

図 12 Function Executor メインウィンドウ

オペレーション作業の実行

Btrieve には数多くのオペレーションがあるため、この章ですべてを説明することはできません。次のセクションでは、一般的ないくつかのオペレーションと、Function Executor を使ったそれらの新しい実行方法についても説明します。

メモ：どのメニューからでもオプションを選択すれば、目的のオペレーションがすぐに実行されます。以前のバージョンの動作のように、グリッドに自動入力したりコマンドの実行待ちになることはありません。また、フォームを閉じると、開いているファイルは閉じられます。Close オペレーションを手動で実行する必要はありません。

全般的なオペレーション - 関連する作業

•ステータスコードのヘルプを見るには

ほかの作業については、以下のセクションを参照してください。

•ファイルを開く作業

•Btrieve ファイルを作成する作業

•履歴の作業

►ステータスコードのヘルプを見るには

1 Function Executor を使用してステータスコードを受け取った場合は、開いているファイルのステータスバーに表示されます。

マウスを動かして赤色で表示されているステータスコード上に移動します。

図 13 ステータスコードを受け取る

2 ステータスコードインジケーターをクリックすると、図 14 のように、そのステータスコードの完全な説明が表示されます。

図 14 ステータスコードの説明

ファイルを開く作業

►Function Executor でデータファイルを開くには

1 ［ファイル］メニューの［開く］を選択します。次のダイアログボックスが表示されます。

図 15 ［Btrieve ファイルのオープン］ダイアログボックス

メモ：クライアント ID：［使用］を無効にしている場合、Function Executor では、BTRV() 関数呼び出しが使用されます。［使用］を有効にしている場合、そのファイルで実行される各オペレーションについて BTRVID() 関数呼び出しが使用されます。［自動］を有効にしている場合、Function Executor では、クライアント ID が自動的に作成されます。［自動］を無効にしている場合には、手動で値を入力できます。

2 ［参照］をクリックします。

3 目的のファイル名をダブルクリックします。

Function Executor でファイルを開くその他の方法

•Windows エクスプローラーから［Btrieve ファイルのオープン］ダイアログボックス内にファイルをドラッグすることができます。ドラッグしたファイル名が［ファイル名］ボックスに入ります。

•メインウィンドウには複数のファイルをドラッグすることができます。

•1 つのファイルを開いてエディターウィンドウを表示しておけば、オペコード（オペレーションコード）0 を使用して別のファイルを開くことができます。そのファイルは新しいウィンドウに表示されます。

•コマンドプロンプトから Function Executor を起動し、ファイル名の一覧を指定して開くことができます。たとえば、次のように指定します。

WBExec32 person.mkd billing.mkd

次のように、ワイルドカードを使用することもできます。

WBExec32 *.mkd

また、.btr、.dat、.mkd やその他の拡張子を持つファイルを Function Executor に関連付けることができます。その後、関連付けされたファイルを Windows エクスプローラー内でダブルクリックすると、Function Executor でそのファイルが開きます。

Btrieve ファイルを作成する作業

Function Executor で Btrieve ファイルを作成する方法には 2 つの方法があります。ファイルが既に開いている場合は、それを複製することができます。そうでなければ、1 から作成します。

注意： Btrieve エンジンは、拡張子を無視してファイル名を使用します。このため、同じディレクトリに、ファイル名が同一で拡張子のみが異なるようなファイルを置かないでください。たとえば、データファイルの 1 つに invoice.btr、もう 1 つに invoice.mkd という名前を付けてはいけません。

方法 1：現在のファイルをテンプレートとして使用する

1 ［ファイル］メニューの［新規作成］を選択します。次のダイアログボックスが表示されます。

図 16 ［ファイル定義の修正］ダイアログボックス

2 このダイアログボックスでキーの操作もできます。［キー］メニューから、［追加］、［削除］、［セグメント］メニューから［追加］、［挿入］、［削除］のいずれかをクリックします。新規ファイルを BUTIL-create での使用の目的でディスクリプションとして保存することもできます。［ディスクリプションとして保存］をクリックし、ファイルの保存先の名前と場所を示します。

3 ファイルを作成するには、［作成］をクリックします。すると、ファイルが開き、作成が完了したことを示すメッセージが表示されます。

方法 2：新しいファイルを始めから作成する

1 メインツールバーの［Btrieve ファイルの作成］アイコンをクリックするか、ファイルがまだ開いていない場合には、前項と同様に［ファイル］メニューの［新規作成］をクリックします。

2 画面上にファイルが既に開かれている場合には、選択ボックスが表示されます。［新規ファイルの作成］を選択します。

3 前と同じダイアログボックスが値が空白の状態で表示され、これに新しい値を入力できます。

4 まず、［キー］メニューを使用するか、Ctrl キーと A キーを同時に押して新規キーを追加します。

5 ダイアログボックスの下部にキーの属性を入力します。

6 必要に応じてキーやセグメントの追加や削除を続けます。これにはメニューを使用するか、一覧表示されたキーを右クリックします。

7 ここで、［作成］ボタンをクリックすると、B_Create（14）オペレーションが実行されます。すると、画面上にそのファイルも自動的に開きます。

履歴の作業

以下の作業は履歴の機能に関連しています。

•履歴ウィンドウを表示するには

•履歴ウィンドウのドッキング状態を切り替えるには

•履歴ウィンドウの常に前面に表示状態を切り替えるには

•履歴ウィンドウをデフォルトの設定にリセットするには

►履歴ウィンドウを表示するには

1 ［表示］>［履歴］を選択するか、［履歴］ボタンをクリックします。

►履歴ウィンドウのドッキング状態を切り替えるには

1 履歴ウィンドウが表示されていない場合は、表示させます（履歴ウィンドウを表示するにはを参照してください）。

2 履歴項目ウィンドウ内で右クリックし、次の図に示すように［ドッキング］オプションのチェックをオンまたはオフにしてドッキング状態を切り替えます。

図 17 履歴ウィンドウのドッキングを解除するには

ドッキングされた場合、履歴ウィンドウはここで示すようにアプリケーションウィンドウに連結されます。ドッキングされない場合、履歴ウィンドウは別個のウィンドウになります。

►履歴ウィンドウの常に前面に表示状態を切り替えるには

1 履歴ウィンドウが表示されていない場合は、表示させます（履歴ウィンドウを表示するにはを参照してください）。

2 この機能は、履歴ウィンドウがドッキングされていない状態でのみ使用できます（履歴ウィンドウのドッキング状態を切り替えるにはを参照してください）。

3 履歴項目ウィンドウで表示を右クリックし、［手前に表示］にチェックを付けるかまたははずします。

►履歴ウィンドウをデフォルトの設定にリセットするには

1 履歴ウィンドウが表示されていない場合は、表示させます（履歴ウィンドウを表示するにはを参照してください）。

2 履歴項目ウィンドウで表示を右クリックし、［設定］>［デフォルト］を選択します。