| ドキュメントのダウンロード | サイトマップ | 用語集 | |
|
|||
| bea ホーム | 製品 | dev2dev | support | askBEA |
|
|
|
|||||||
 |
| e-docs > Tuxedo > Windows NT での Tuxedo システムの使用 > Visual C++ IDE による BEA Tuxedo ATMI アプリケーションの開発 |
|
Windows NT での Tuxedo システムの使用
|
Visual C++ IDE による BEA Tuxedo ATMI アプリケーションの開発
以下の節では、Windows 98、Windows XP、または Windows 2000 システム上で Microsoft Visual C++ 統合開発環境 (msdev)を使用して ATMI アプリケーション・クライアントおよびサーバを開発する方法について説明します。
はじめに
Windows 98 または Windows XP には BEA Tuxedo ATMI クライアント (サーバ・コンポーネントは別) をインストールできるので、それらのプラットフォームでは、Microsoft Visual C++ IDE で ATMI アプリケーション・クライアントのみ開発できます。.一方、Windows 2000 には BEA Tuxedo ATMI クライアントとサーバの両コンポーネントをインストールできるので、Windows 2000 プラットフォームでは、Microsoft Visual C++ IDE で ATMI アプリケーション・クライアントとアプリケーション・サーバの両方を開発できます。
開発ツールを使用する
BEA Tuxedo ATMI は、Microsoft Visual C++ IDE (msdev) に統合されますが、統合できない場合は、msdev の機能がエミュレートされます。このような統合により、16 ビットまたは 32 ビットの Windows オペレーティング・システムで動作する BEA Tuxedo ATMI アプリケーションを簡単に開発できます。
BEA Tuxedo ATMI のサービス要求の作成や送信、会話型接続の確立、および応答の受信を実現するためのコーディングは、基本的に UNIX 環境と Windows 2000 環境で同じです。開発支援ツールとして、BuildTuxedo と TUXDEV が用意されています。
buildserver コマンドおよび buildclient コマンドを使用する
buildclient() コマンドと buildserver() コマンドは両方とも Windows 2000 で利用できますが、Windows 98 と XP では両方は利用できません。Windows 98 と XP では、buildclient() コマンドのみ利用できます。つまり、Windows 98 システムと Windows XP システムで作成できるのは Tuxedo アプリケーション・クライアントのみです。build コマンドの詳細については、『BEA Tuxedo コマンド・リファレンス』の buildclient(1) と buildserver(1) を参照してください。
buildclient() コマンドと buildserver() コマンドのオプションは、次の表で示されているように統合開発環境とそれ以外の環境では異なる働きをします。
統合開発環境でビルド環境を変更するには、次の手順に従います。
注記 CC および CFLAGS は、不要になりました。
ライブラリを指定し、統合開発環境のパスを指定するには、次の手順に従います。
MSDEV の [Tools] メニューに BuildTuxedo を追加する
MSDEV の [Tools] メニューに BuildTuxedo を追加するには、次の手順に従います。
図 3-1 [Customize] ウィンドウの [Tools] ページ
をクリックして [Menu Contents] ボックスを表示し、[Menu Contents] ボックスの最後の空白のボックスに「&BuildTuxedo」を入力して、Enter キーを押します。
これで、BuildTuxedo が MSDEV の [Tools] メニューに表示されます。
BEA Tuxedo の ATMI プロジェクト・ファイルを作成する
BuildTuxedo は、BEA Tuxedo ATMI アプリケーションごとに作成される個別のプロジェクト・ファイルを、カレント・ディレクトリ内に保持します。BuildTuxedo が起動すると、カレント・ディレクトリ内にある有効なプロジェクト・ファイルが検索されます。有効なプロジェクト・ファイルが見つかると、ダイアログ・ボックス内の値がこのファイル内の値に設定され、ダイアログ・ボックスが表示されます。タイトル・バーには次のように表示されます。
BuildTuxedo project_name
BuildTuxedo プロジェクトは、カレント・ディレクトリ内の msdev プロジェクトと密接に関連するため、BuildTuxedo は、次の 2 つのファイルも検索します。
BuildTuxedo が上記のどちらかのファイルを検索できない場合は、警告メッセージが表示され、起動は失敗します。ディレクトリに複数の BuildTuxedo プロジェクト・ファイル、msdev プロジェクト・ファイル、または make ファイルがある場合は、適切なファイル名があるメニュー項目が [System] メニューに追加されます。
作業中のプロジェクト・ファイルを保存するには、[OK] または [Apply] を選択します。プロジェクト・ファイルまたは BEA Tuxedo システムが保持するその他のファイルに対する変更内容をキャンセルするには、[Cancel] をクリックするか、または Esc キーを押します。
環境を設定する
統合開発環境で BEA Tuxedo ATMI アプリケーションをビルドするには、使用する環境内で次の基本的なパラメータを設定しておく必要があります。
これらの情報を設定するには、msdev の GUI 画面で、[BuildTuxedo project_name] ダイアログ・ボックスを表示します。
ビルド・タイプ、ヘッダ・ファイル、およびファイル名を指定する
ビルド・タイプ、ヘッダ・ファイル、およびファイル名を指定するには、次の手順に従います。
図 3-2 [Build] ページ
注記 Windows 98 または XP のユーザが選択できるのは、ワークステーション・クライアントのみです。
[Initialization] フィールドおよび [Cleanup] フィールドに指定された有効な関数名は、デフォルトの init/exit 関数をオーバーライドします。[Entry Point] フィールドには、BuildTuxedo が生成する関数の名前を指定できます。関数名を指定しておくと、後でアプリケーションのどこからでもこの関数を呼び出せます。
BuildTuxedo でヘッダ・ファイルを使用する
BuildTuxedo は、現在の BEA Tuxedo ATMI プロジェクトを正しく作成するために必要な pragma 文をヘッダ・ファイルに追加します。BuildTuxedo は、[Build] ページの [Header File] フィールドに指定されたファイルがあるときはこれを開きます。指定されたファイルがないときは、このファイルを作成します。次の行で始まり、
//Begin Tuxedo Section*****DO NOT EDIT*****
次の行で終わるセクションは、
//End Tuxedo Section
ヘッダ・ファイルで pragma 文が書き込まれる部分です。この部分は、BuildTuxedo によって管理されます。このセクションが見つからない場合、BuildTuxedo はヘッダ・ファイルの最後にこのセクションを付加します。これ以外のファイル内のテキストは変更されないため、ヘッダ・ファイルには「stdafx.h」という名前を指定できます。
注記 新しいプロジェクトを作成して [OK] または [Apply] を選択した場合は、MSDEV の [Insert] メニューの [Files into Project] を選択する必要があります。次に、BuildTuxedo が生成したファイルを現在のプロジェクトに追加します。この操作は、新しいプロジェクトの場合、または C/C++ 出力ファイルの名前を変更するときにのみ実行します。
関数名とサービス名を指定する
[Services] タブを選択すると、[Services] ページが表示されます。[Services] ページでは、関数名とサービス名を指定します。
図 3-3 [Service] ページ
[Services] ページでは、サービス・ディスパッチ・テーブルの管理に使用される 2 つの一覧が表示されます。
注記 表を上または下にスクロール表示したいときは、矢印キーを使用します。
通常、サービスと、そのサービスを実行する関数には同じ名前を付けます。たとえば、関数 x はサービス x を実行します。ただし、実行するサービスとは異なる名前が付いた関数もあります。たとえば、関数 abc が、x、y、および z の 3 つのサービスを実行する場合があります。別のケースでは、実行時までサービス名が分からないことがあります。
サーバを構築するときは、サービスに関連する関数を指定する必要があります。サービスに関連する関数には、サービス、プロトタイプ、C リンク、無効な戻り値、および TPSVCINFO ポインタ・パラメータを 1 つ指定する必要があります。サービス名をマッピングする関数を指定するには、この関数を [Function Name] 一覧に追加しておく必要があります。この情報は、サービス・ディスパッチ・テーブルに必要です。
注記 buildserver(1) コマンドを使用する場合は、-s オプションを指定すると、この情報が提供されます。-s オプションの詳細については、『C 言語を使用した BEA Tuxedo アプリケーションのプログラミング』または『COBOL を使用した BEA Tuxedo アプリケーションのプログラミング』を参照してください。
[Function Names] に名前を追加または編集するには、次の手順に従います。
リソース・マネージャを指定する
リソース・マネージャを指定するには、次の手順に従います。
図 3-4 [Resources] ページ
注記 [Tuxedo Resource Manager] フィールドには、システムで利用可能な BEA Tuxedo のリソース・マネージャの一覧が用意されています。これらのリソース・マネージャは、%TUXDIR%¥udataobj¥RM ファイルで定義されています。定義済みのファイルがない場合は、デフォルトの「NONE」が表示されます。
BEA Tuxedo ATMI のサーバ・アプリケーションをデバッグする
次の手順は、プロジェクトでデバッグ・コンフィギュレーションを使用してサーバ・アプリケーションをビルドした場合にのみ適用できます。
まだ起動していないサーバをデバッグするには、次の手順に従います。
注記 実行中のサーバをデバッグする場合は、Windows 2000 のコマンド・プロンプトに「msdev -p nnn」と入力してください。「nnn」には、サーバのプロセス ID (10 進数) を指定します。
Visual C++ IDE GUI の代わりにコマンド行オプションを使用して ATMI アプリケーションを開発する
Microsoft Visual C++ IDE GUI の代わりにコマンド行を使用して BEA Tuxedo ATMI アプリケーションを開発する必要がある場合、buildserver(1) コマンドと buildclient(1) コマンドを使用します。まず、BEA Tuxedo ATMI アプリケーションのビルドに必要なコンパイラとリンク・オプションを指定します。これらのツールの使用方法については、以下のマニュアルを参照してください。
buildserver または buildclient を使用して ATMI アプリケーションのデバッグ・バージョンをビルドするには、/Zi および /Od オプションを指定して、すべてのソース・ファイルをコンパイルする必要があります。/Zi は、デバッグを有効にするオプションです。/Od は、最適化を無効にするオプションです。さらに、_DEBUG プリプロセッサ・ディレクティブの定義が必要な場合もあります。このプロセスを完了するには、次のリンク・オプションを指定します。
-l"/link/debug:full /debugtype:both"
Tuxdev アプリケーションを使用する
Tuxdev アプリケーションをインストールするには、次の手順に従います。
をクリックして [Menu Contents] ボックスを表示し、[Menu Contents] ボックスの最後の空白のボックスに「&Tuxdev」を入力して、Enter キーを押します。
注記 ツールのホット・キーを作成するには、ツール名の先頭にアンパサンド (&) を追加します。これで、その文字を入力するだけでツールを呼び出すことができます。
BEA Tuxedo ATMI のエディタを使用する
この環境では、FML テーブル・エディタと VIEW テーブル・エディタを使用できます。どちらのインターフェイスでも、複数のドキュメントやビューを同時に表示できるため、ワークブックと同じ感覚で操作できます。また、さまざまな種類のファイルを同時に編集することもできます。これらのエディタは、Microsoft Excel のスプレッドシートに似ています。
FML テーブル・エディタを使用する
FML テーブル・エディタを起動するには、次の手順に従います。
図 3-6 FML テーブル・エディタ
前の図に示すように、FML テーブル・エディタには、[Name]、[Number]、[Type]、[Flag]、[Comment]、の 5 つの列があります。行数の制限はありません。
次の表は、FML テーブル・エディタの各列の説明です。
新しい (名前の付いていない) FML テーブルを開くと、FML Tablex というテーブル名で空白行が作成されます。x は、MDI によって割り当てられ、新しいテーブルが作成されるたびに 1 つづつ増えます。テーブルを保存するときは名前を指定することができます。また、既存のテキスト・ファイルを開いて、編集することもできます。特に指定されていない限り、ファイルは、タブ区切り形式で、ファイルを開いたディレクトリ内に保存されます。保存時には、必要に応じて、ファイル名の最後に拡張子 .fml が追加されます。このファイルをコンパイルして、16 ビットまたは 32 ビットの FML ヘッダ・ファイルを作成することもできます。 VIEW テーブル・エディタを使用する VIEW テーブル・エディタを起動するには、次の手順に従います。
図 3-7 VIEW テーブル・エディタ
図が示すように、VIEW テーブル・エディタには、[CName]、[FBName]、[Type]、[Count]、[Flag]、[Size]、[Null] の 7 つの列があります。行数の制限はありません。
[CName] 列にはコメントを入力できます。ただし、コメントの先頭にはシャープ (#) を付ける必要があります。空白行はあってもかまいません。[CName] 列のエントリの先頭に # がなく、ヌルでもない場合、この行はアクティブなテーブル・エントリと見なされます。
次の表は、VIEW テーブル・エディタの各列の説明です。
注記 VIEW 情報の始めと終わりを示すため、次の情報を指定する必要があります。
VIEW table_name
.
.
.
END
この情報は、[CName] 列の行に表示されなければなりません。同じファイル内に複数の VIEW を入力することもできます。ただし、各テーブル・エントリは必ず「VIEW table_name」と「END」で囲んでください。
新しい (名前の付いていない) VIEW ファイルを開くと、Viewx という VIEW 名で空白行が作成されます。x は、MDI によって割り当てられ、新しい VIEW が作成されるたびに 1 つづつ増えます。VIEW を保存するときは名前を指定することができます。また、既存の VIEW ファイル (テキスト形式またはバイナリ形式) を開いて、編集することもできます。特に指定されていない限り、ファイルは、タブ区切り形式で、ファイルを開いたディレクトリ内に保存されます。保存時には、必要に応じて、ファイル名の最後に拡張子 .v が追加されます。このファイルをコンパイルし、16 ビットまたは 32 ビットの VIEW ヘッダ・ファイルを作成することもできます。
複数のドキュメントを同時に処理する
基本的なフレームワークに組み込まれている MDI により、複数の異なる形式のドキュメントや VIEW を同時に開くことができます。たとえば、msdev、Excel、Word などがその良い例です。BEA Tuxedoでは、x 個の FML テーブルと、y 個の VIEW ファイルを開き、それらの 1 つを使用することができます。各ドキュメントは、オープン状態のドキュメントごとにタブが付いたワークブックのようなものです。
エディタを使用してエントリの妥当性を検証する
次の表は、FML テーブル・エディタの各列で検証される情報の説明です。
次の表は、VIEW テーブル・エディタの各列で検証される情報の説明です。
関連項目
BEA Tuxedo ATMI については、以下のマニュアルを参照してください。
|
|
|
|
||
 |
|
|
 |
 |
 |
|
||
をクリックして、適切なディレクトリで buildtuxedo.exe を選択し、[Open] をクリックします。選択したパス名が [Customize] ウィンドウに表示されます。
¥
をクリックして、適切なディレクトリで tuxdev.exe を選択し、[Open] をクリックします。選択したパス名が [Customize] ウィンドウに表示されます。