XMLSTOCKAPP のチュートリアル

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > サンプルを使用した Tuxedo アプリケーションの開発方法 > XMLSTOCKAPP のチュートリアル

サンプルを使用した Tuxedo アプリケーションの開発方法

XMLSTOCKAPP のチュートリアル

ここでは、次の内容について説明します。

XMLSTOCKAPP とは

XMLSTOCKAPP は、BEA Tuxedo システム・ソフトウェアに同梱されている株式売買の ATMI サンプル・アプリケーションです。このアプリケーションでは、単一のマシン上にある 2 つのサーバを実行し、C および C++ Tuxedo サーバからのパーサの呼び出しと XML バッファのルーティングを示します。片方のサーバは C++ で記述された Tuxedo サーバです (stockxml)。もう一方のサーバは C で記述されています (stockxml_c)。2 つのサーバは同じ STOCKQUOTE サービスを提供します。クライアントはサービスを呼び出し、株価を返します。次に XML バッファを出力します。

ここでは、XMLSTOCKAPP アプリケーションを開発する方法について、手順を順に示して説明します。このチュートリアルに従って XMLSTOCKAPP の「開発」を経験すると、独自のアプリケーションを開発できるようになります。

XMLSTOCKAPP チュートリアルは、次の 3 つの節から構成されています。

注記ここで説明する内容は、アプリケーションの開発、管理、プログラミングに経験のあるシステム・ユーザを対象としています。また、BEA Tuxedo システム・ソフトウェアについて理解していることを前提としています。BEA Tuxedo アプリケーションをビルドするには、開発ラインセンスが必要です。

XMLSTOCKAPP について

ここでは、XMLSTOCKAPP アプリケーションを構成するファイル、クライアント、およびサービスについて説明します。それぞれの詳細については以下を参照してください。

XMLSTOCKAPP のファイルについて

XMLSTOCKAPP アプリケーションを構成するファイルは、samples/atmi/xmlstockapp ディレクトリに置かれています。このサンプルに用意されているファイルは、次のとおりです。

XMLSTOCKAPP ディレクトリには、次のファイルが置かれています。

クライアントへの 2 つの .xml 入力ファイル: stock_quote_beas.xml および stock_quote_msft.xml
1 つのクライアント: Client.cpp
2 つのサーバ・ファイル: stockxml および stockxml_c
STOCKAPP をサンプル・アプリケーションとして実行するためのファイル

XMLSTOCKAPP クライアントの検証

BEA Tuxedo システムの ATMI クライアント/サーバ・アーキテクチャでは、通信に次の 2 つのモードがあります。

要求/応答モード。サーバが実行する 1 つのサービス要求を送り、1 つの応答を受け取ります。
会話モード。クライアント (またはクライアントとして動作するサーバ) とサーバ間に専用の接続が確立されます。終了するまで、この接続はアクティブになったままです。接続がアクティブである限り、参加している 2 つのプロセス間で、サービスに対する要求と応答をそれぞれ含むメッセージをやり取りできます。

XMLSTOCKAPP では要求/応答モードをインプリメントし、STOCKQUOTE サービスを使用して株価を要求します。

BEAS または MSFT の株価の要求。
XML ファイル内の単一の引数で実行されるクライアントが、STOCKQUOTE サービスを呼び出します。
サービスは XML バッファを株価で更新します。
クライアントは XML バッファを出力します。

要求/応答クライアント: stock_quote_beas.xml

Client.cpp は XML ファイル stock_quote_beas.xml または stock_quote_msft.xml からの入力を使用するクライアント・プログラムです。STOCKQUOTE サービスを呼び出す照会を行い、BEAS または MSFT の株価を返します。このプログラムは、次のように実行可能プログラムとして呼び出します。

Client stock_quote_beas.xml

または

Client stock_quote_msft.xml

関連項目

『BEA Tuxedo システム入門』の 2-5 ページの「ATMI の使用」
『BEA Tuxedo システム入門』の 2-27 ページの「型付きバッファ」
『BEA Tuxedo コマンド・リファレンス』および『BEA Tuxedo C リファレンス』の ATMI コマンドおよび関数

XMLSTOCKAPP サーバの検証

ATMI サーバとは、1 つ以上のサービスを提供する実行可能プロセスです。BEA Tuxedo システムでは、サーバはクライアントとして動作するプロセスから継続的に要求を受け取り、それを適切なサービスに転送します。BEA Tuxedo システムのトランザクション処理アプリケーションの機能性は、これらのサービスがリソース・マネージャにアクセスすることによって実現されます。サービス・ルーチンは、BEA Tuxedo システム・プログラマによって作成されなければならないアプリケーションの一部です。ユーザ定義のクライアントは、アプリケーションの別の部分に相当します。

XMLSTOCKAPP プログラムの STOCKQUOTE サービスは、アプリケーション・トランザクション・モニタ・インターフェイス (ATMI) で提供される機能を使用して、クライアントに XML バッファとして株価を返します。

XMLSTOCKAPP のファイルおよびリソースの準備

ここでは、XMLSTOCKAPP を実行するために必要なファイルやリソースを作成するための手順を順に示します。

ステップ 1: 新しいディレクトリへの XMLSTOCKAPP ファイルのコピー

ファイルを編集したりサンプルを実行したりする前に、XMLSTOCKAPP ファイルを独自のディレクトリにコピーしておくことをお勧めします。

ステップ 2: 環境変数の設定

環境変数ファイルを編集する必要があります。

TUXDIR が設定されていることを確認します。設定されていない場合、ファイルの実行が失敗して、次のメッセージが表示されます。
```
TUXDIR:parameter null or not set
```
TUXDIR パラメータに BEA Tuxedo システムのディレクトリ構造でのルート・ディレクトリを設定し、エクスポートします。
APPDIR を {TUXDIR}/samples/atmi/XMLSTOCKAPP ディレクトリに設定します。これは、XMLSTOCKAPP のソース・ファイルが置かれたディレクトリです。APPDIR は、BEA Tuxedo システムによって、アプリケーション固有のファイルが検索されるディレクトリです。オリジナルのソース・ファイルを上書きしないように XMLSTOCKAPP ファイルを別のディレクトリにコピーした場合は、そのディレクトリを入力します。TUXDIR の下位ディレクトリである必要はありません。
環境変数ファイルに必要な変更を加えたら、次のように実行します。
```
. ./<VARFILE>
```
<VARFILE> は環境変数ファイルの名前です。

そのほかの要件

HP-UX と AIX の場合を除いて、LD_LIBRARY_PATH には、共用ライブラリを使用するシステムの $TUXDIR/lib が含まれている必要があります。

AIX の場合、LD_LIBRARY_PATH ではなく LIBPATH を設定します。
HP-UX の場合、LD_LIBRARY_PATH ではなく SHLIB_PATH を設定します。
オペレーティング・システムが Sun Solaris の場合、PATH の先頭で /usr/5bin を指定する必要があります。次のコマンドを使用します。
```
PATH=/usr/5bin:$PATH;export PATH
```
シェルとしては、csh ではなく /bin/sh を使用します。

ステップ 3: クライアントのビルド

クライアントをビルドするには、以下のコマンドを使用します。

export CFLAGS=-I

特定のオペレーティング・システムの場合は、以下のコマンドを使用します。

Solaris の場合
```
export CC=CC
```
HP-UX の場合
```
export CC=aCC
```
Digital Unix の場合
```
export CC=cxx
```
AIX の場合
```
export CC=xlC_r
```
Linux の場合
```
export CC=g++
```

クライアントをビルドするには、以下のコマンドを使用します。

buildclient -o Client -f Client.cpp -f SAXPrint.cpp -f SAXPrintHandlers.cpp -f -ltxml

ステップ 4: XMLSTOCKAPP でのサーバのビルド

XMLSTOCKAPP サンプルには 2 つのサーバが用意されています。ただし、このサンプルのサーバをビルドするには、README ファイルの指示に従う必要があります。

実行可能な ATMI サーバをビルドするには、buildserver を使用します。このコマンドではオプションを使用して、出力ファイル、アプリケーションで提供される入力ファイル、各種の方法で BEA Tuxedo システム・アプリケーションを実行するためのライブラリを指定します。

buildserver のコマンド行で指定できる主なオプションを以下の例に示します。

buildserver コマンドは .mk で使用され、株式アプリケーションの各サーバをコンパイルしてビルドします。詳細については、『BEA Tuxedo コマンド・リファレンス』の buildserver(1) を参照してください。

stockxml および stockxml_c サーバのビルド

次のように、buildserver コマンドで stockxml サーバと stockxml_c サーバをビルドします。

buildserver -s STOCKQUOTE -o stockxml -f stockxml.cpp -f DOMTreeErrorReporter.cpp -f -ltxml
buildserver -s STOCKQUOTE -f stockxml_c.c -o stockxml_c -f xmlWrapper.cpp -f DOMTreeErrorReporter.cpp -f -ltxml

以下は、コマンド行で指定されている各オプションの説明です。

-o オプションは、実行可能出力ファイルに名前を指定する場合に使用します。名前が指定されていない場合は、SERVER という名前が付きます。
-s オプションは、サーバの起動時に宣言されるサーバのサービス名を指定します。サービスを実行する関数名がサービス名と異なる場合、関数名が -s オプションの引数の一部になります。XMLSTOCKAPP では、関数名はサービス名と同じなので、サービス名だけを指定します。サービス名では、すべての文字列を大文字で指定します。ただし、buildserver の -s オプションでは、サーバ内のサービスを処理する関数には任意の名前を付けることができます。詳細については、『BEA Tuxedo コマンド・リファレンス』の buildserver(1)を参照してください。システム管理者は、buildserver コマンドでサーバを作成した際に使用されたサービスのサブセットだけをサーバの起動時に利用できるように設定することもできます。詳細については、『BEA Tuxedo アプリケーション実行時の管理』および『BEA Tuxedo アプリケーションの設定』を参照してください。
-f オプションは、リンク時と編集時に使用されるファイルを指定します。buildserver リファレンス・ページの -l オプションも参照してください。ファイルがリストされる順序には意味があります。この順序は、関数の参照、およびその参照がどのライブラリで解決されるかによって決定されます。ソース・モジュールは、関数の参照が解決されるライブラリの前にリストされます。オブジェクト・ファイルは、別個の .o ファイル、またはアーカイブ (.a) ファイルにあるファイル・グループです。-f の引数として 1 つ以上のファイル名を指定する場合は、二重引用符で各ファイル名を囲む必要があります。-f オプションは、必要な数だけ使用できます。
-s オプションは、stockxml および stockxml_c サーバを構成するサービスとして STOCKQUOTE サービスを指定します。-o オプションは実行可能出力ファイルに stockxml および stockxml_c という名前を付け、-f オプションは stockxml.cpp、DOMTreeErrorReporter.cpp、および xmlWrapper.cpp ファイルがビルドでのリンク時と編集時に使用されることを指定します。

関連項目

ステップ 5: コンフィギュレーション・ファイルの編集

ubbsimple サンプル・コンフィギュレーション・ファイルを編集して、山かっこで囲まれた項目を実際のインストールに適した値に置き換える必要があります。TUXDIR および TUXCONFIG 環境変数はコンフィギュレーション・ファイルの値と一致していなければなりません。

コードリスト6-1 ubbsimple コンフィギュレーション・ファイル

1$
2
3 #BEA Tuxedo サンプル・アプリケーションのスケルトン・ファイルです。
4 #<山かっこで囲まれた文字列> を適切な値で置き換えます。
5 RESOURCES
6 IPCKEY            <32,768 よりも大きい IPC キーで置き換えます。>
7
8 #例:
9
10 #IPCKEY         62345
11
12 MASTER          simple
13 MAXACCESSERS    5
14 MAXSERVERS      5
15 MAXSERVICES     10
16 MODEL           SHM
17 LDBAL           N
18 
19 *MACHINES
20
21 DEFAULT:
22
23 			        APPDIR="<現在のパス名で置き換えます。>"
24	         TUXCONFIG="<TUXCONFIG のパス名で置き換えます。>"
25         TUXDIR="<Tuxedo のルート・ディレクトリ (/ 以外) を指定します。>"
26 #例:
27 #       APPDIR="/usr/me/simpdir"
28 #       TUXCONFIG="/usr/me/simpdir/tuxconfig"
29 #       TUXDIR="/usr/tuxedo"
30
31 <Machine-name>  LMID=simple
32 #例:
33 #tuxmach        LMID=simple
34 *GROUPS
35 GROUP1
36              LMID=simple   GRPNO=1  OPENINFO=NONE
37
38 *SERVERS
39  DEFAULT:
40              CLOPT="-A"
41  stockxml    SRVGRP=GROUP1 SRVID=1
42  stockxml_c  SRVGRP=GROUP1 SRVID=1
43 *SERVICES
44  STOCKQUOTE

山かっこで囲まれた各 <文字列> を適切な値に置き換えます。

関連項目

ステップ 6: バイナリ形式のコンフィギュレーション・ファイルの作成

バイナリ形式のコンフィギュレーション・ファイルを作成する場合、XMLSTOCKAPP ファイルが置かれたディレクトリに移動し、環境変数を設定することが必要です。その場合、次の手順に従います。

XMLSTOCKAPP ファイルが置かれたディレクトリに移動します。
次のコマンドを入力して、環境変数を設定します。
```
. ./<variable_file>
```
<variable_file> は変数ファイルの名前です。

コンフィギュレーション・ファイルのロード

コンフィギュレーション・ファイルを編集したら、それを MASTER マシン上にバイナリ・ファイルとしてロードする必要があります。バイナリ形式のコンフィギュレーション・ファイルの名前は TUXCONFIG、そのパス名は TUXCONFIG に定義されています。このファイルは、BEA Tuxedo のシステム管理者の有効なユーザ ID およびグループ ID を持つユーザが作成します。この 2 つの ID は、ご使用のコンフィギュレーション・ファイルの UID および GID の値と同じであることが必要です。同じではない場合、XMLSTOCKAPP の実行時にパーミッションの問題が発生します。