Format Builder

メタデータのインポート

BEA Format Builder には以下のユーティリティが含まれており、これらのユーティリティを使用して COBOL コピーブックをインポートし、C 構造体定義を MFL メッセージ定義に変換することができます。

XML スキーマのインポート

Format Builder には、非 XML ドキュメントの XML 表現を適切に表す XML スキーマをインポートする機能があります。この機能により、非 XML ドキュメントのフォーマットを指定する作業をすぐに始めることができます。

XML スキーマをインポートするには、次の手順に従います。

[Tools｜Import｜XML Schema Importer] を選択します。XML Schema Importer ダイアログが表示されます。

次の表に従って、フィールドにデータを入力します。

フィールド	説明
[XML Schema Definition]	インポートするファイルのパスと名前を入力する。
[Browse]	クリックして、インポートするファイルの場所に移動する。
[Root Element]	この値は変換後の XML ドキュメントのルート要素として使用される。この名前は XML 要素の命名規則に準拠する必要がある。
[MFL Field Delimiter Default]	区切り記号とは、フィールドの終わりをマークする文字。フィールドデータは区切り記号を含むフィールドが見つかるまで続く。
アクションボタン
[OK]	定義した設定を使用して XML スキーマをインポートする。
[Cancel]	インポートせずにダイアログを閉じて Format Builder に戻る。

COBOL コピーブックのインポート

Format Builder には、COBOL コピーブックを Format Builder にインポートして、COBOL データを変換するためのメッセージ定義を作成する機能があります。コピーブックのインポート時には、インポートされるコピーブックとそれに含まれるグループおよびフィールドを説明するためにコメントが使用されます。

COBOL コピーブックをインポートするには、次の手順に従います。

[Tools｜Import｜COBOL Copybook Importer] を選択します。[COBOL Copybook Importer] ダイアログが表示されます。

次の表に従って、フィールドにデータを入力します。

フィールド	説明
[File Name]	インポートするファイルのパスと名前を入力する。
[Browse]	クリックして、インポートするファイルの場所に移動する。
[Byte Order]
[Big Endian]	バイトオーダーをビッグエンディアンに設定する場合はこのオプションを選択する。注意 : このオプションは、IBM 370、Motorola、および大半の RISC 設計 (IBM メインフレームやほとんどの UNIX プラットフォーム) に使用される。
[Little Endian]	バイトオーダーをリトルエンディアンに設定する場合はこのオプションを選択する。注意 : このオプションは、Intel、VAX、および Unisys プロセッサ (Windows、VMS、Digital、UNIX、および Unisys) に使用される。
[Character Set]
[EBCDIC]	文字セットを EBCDIC に設定する場合に、このオプションを選択する。注意 : これらの値は、インポート元のホストマシンの属性である。
[US-ASCII]	文字セットを US-ASCII に設定する場合に、このオプションを選択する。注意 : これらの値は、インポート元のホストマシンの属性である。
[Other]	フィールドデータの文字エンコーディング。
アクションボタン
[OK]	定義した設定を使用して COBOL コピーブックをインポートする。
[Cancel]	インポートせずにダイアログを閉じて Format Builder に戻る。
[About]	COBOL Copybook Importer のバージョンやサポートされているコピーブック機能などの情報を表示する。

インポートしたコピーブックは、他のメッセージフォーマット定義と同じように使用できます。コピーブックにエラーやサポートされていないデータ型が含まれている場合は、エラーを通知するメッセージが表示されます。エラーを表示するか、または今後の参考にエラーをログファイルに保存するかを選択できます。

C 構造体のインポート

Format Builder には、MFL または C コード出力を生成して C 構造体定義を MFL メッセージ定義に変換するための C Struct Importer ユーティリティが含まれています。

C Struct Importer の起動

C Struct Importer を起動するには、次の手順に従います。

Format Builder のメインウィンドウで [Tools｜Import｜C Struct Importer] を選択します。[C Struct Importer] ダイアログが表示されます。

[C Struct Importer] ダイアログには、デフォルトの出力として [MFL] が指定されており、以下のフィールドが含まれています。

フィールド	説明
[Input]
[Input File]	インポートするファイルのパスと名前を入力する。[Browse] ボタンをクリックして、インポートするファイルを指定することも可能。
[Structure]	このリストボックスには、入力ファイルの解析後、検出された構造体のリストが表示される。
[Parse]	[Parse] をクリックして入力ファイルを解析する。解析に成功すると、入力ファイル内の構造体リストが [Structure] リストボックスに表示される。
[Output]
[Name]	ファイル名を入力するか、または [Browse] ボタンを使用して、既存のプロファイルを指定する。
[MFL]	MFL を生成するために、対象マシン上でコンパイルが必要なデータを指定する。
[C Code]	C コードを生成するために、対象マシン上でコンパイルが必要なデータを指定する。

MFL データの生成

MFL データを生成するには、以下の手順に従います。

[Input File] フィールドにファイル名を入力するか、[Browse] をクリックしてファイルを選択します。

[Parse] をクリックしてファイルを解析します。

解析が完了すると、入力ファイル内の構造体リストが [Structure] リストボックスに表示されます。

目的の構造体を [Structure] ドロップダウンリストから選択します。

MFL を直接生成するためには、この時点でプロファイルのコンフィグレーションデータを入力する必要があります。これらのデータ入力は、ハードウェアプロファイルを新しく作成するか、または既存のプロファイルを指定して行うことができます。

既存のプロファイルを指定する、または新たにプロファイルを作成するには、次の手順に従います。

既存のプロファイルを指定する場合、[Hardware Profile] の [Name] フィールドにファイル名を入力するか、[Browse] をクリックしてファイルを選択します。プロファイルパラメータを参照または編集するには、[Edit] をクリックしてハードウェアプロファイルエディタを開きます。
新しいハードウェアプロファイルを作成する場合、[New] をクリックします。デフォルトパラメータがロードされたハードウェアプロファイルエディタが開きます。プロファイル名と説明を指定し、基本データ型とバイトオーダーを必要に応じて変更します。

[OK] をクリックしてハードウェアプロファイルの変更を保存し、[C Struct Importer] ダイアログボックスに戻ります。

[OK] をクリックして MFL を生成します。生成が成功すると、Format Builder に戻り、ナビゲーションツリーに MFL オブジェクトが表示されています。生成された MFL オブジェクトには、解析で使用された入力ファイルの名前が反映されます。

生成プロセスでエラーが検出された場合は、[MFL Generation Errors] ダイアログが表示されます。このダイアログを使用して、エラーログを表示するかまたはファイルとして保存することができます。

[Display Error Log] をクリックしてエラーを表示するか、[Save Error Log] をクリックして指定した場所にエラーログを保存するか、[Cancel] をクリックして [MFL Generation Errors] ダイアログボックスを閉じます。

発生したエラーを確認したら、[C Struct Importer] に戻って前の手順を繰り返すことができます。

C コードの生成

C コードを生成するには、以下の手順に従います。

[Input File] フィールドにファイル名を入力するか、[Browse] をクリックしてファイルを選択します。

[Parse] をクリックしてファイルを解析します。

解析が完了すると、入力ファイル内の構造体リストが [Structure] リストボックスに表示されます。

目的の構造体を [Structure] ドロップダウンリストから選択します。

[C Code] オプションボタンを選択します。

[MFL Gen] フィールドまたは [Data Gen] フィールドにファイル名を入力するか、[Browse] をクリックしてファイルを選択します。

[OK] をクリックします。既存ファイルの上書きに関する警告と、コード生成の成功または失敗を通知するメッセージが表示されます。

生成されたソースコードを対象のプラットフォームにコピーし、ソースコードをコンパイルして実行します。

注意 : 構造体の宣言を含む入力ファイルもコピーする必要があります。コンパイルが完了すると、両方のプログラムで出力ファイル名の引数が取り込まれます。

生成された MFL またはデータを、Format Builder を実行しているプラットフォームにコピーします。

メタ データのインポート