プログラミング環境

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

• UBBCONFIG コンフィギュレーション・ファイルの更新

• 環境変数の設定

• 必要なヘッダ・ファイルのインクルード

• アプリケーションの起動と停止

 

---

UBBCONFIG コンフィギュレーション・ファイルの更新

アプリケーション管理者は、最初に UBBCONFIG コンフィギュレーション・ファイルにアプリケーションのコンフィギュレーションを定義します。プログラミング環境をカスタマイズするには、コンフィギュレーション・ファイルを作成するか更新します。

コンフィギュレーション・ファイルの作成または更新を行う場合は、次のガイドラインを参考にしてください。

• 既存のファイルをコピーして編集します。たとえば、サンプル・アプリケーション bankapp に付属するファイル ubbshm から作業を開始します。

• 複雑性を最小限にします。テストを行う場合は、共用メモリを使用する単一プロセッサ・システムとしてアプリケーションを設定します。データとしては、通常のオペレーティング・システムのファイルを使用します。

• コンフィギュレーション・ファイルの IPCKEY パラメータが、インストールされているシステムで使用されているほかのパラメータと競合しないようにします。詳細については、BEA Tuxedo アプリケーション管理者に確認し、『BEA Tuxedo アプリケーションの設定』を参照してください。

• UID および GID パラメータを設定し、定義したコンフィギュレーションが自分自身のものであることを示します。

• マニュアルを参照します。コンフィギュレーション・ファイルについては、『BEA Tuxedo のファイル形式とデータ記述方法』の UBBCONFIG(5) で説明しています。

次の表は、プログラミング環境に影響する UBBCONFIG コンフィギュレーション・ファイルのパラメータを示しています。パラメータは機能別に分類されています。

表 2-1 プログラミング関連の UBBCONFIG パラメータ (機能別)

機能	パラメータ	セクション	説明
グローバル・リソースの制限	MAXSERVERS	RESOURCES	コンフィギュレーション内のサーバの最大数。この値を設定する場合は、すべてのサーバの MAX 値を考慮する必要があります。
	MAXSERVICES	RESOURCES	コンフィギュレーション内のサービスの最大総数。
データ依存型ルーティング	BUFTYPE	ROUTING	指定されたルーティング・エントリが有効であるデータ・バッファのタイプとサブタイプのリスト。
リンク・レベルの暗号化	MINENCRYPTBITS	NETWORK	プロセスで使用できる暗号化の最低レベル。
	MAXENCRYPTBITS	NETWORK	プロセスで使用できる暗号化の最高レベル。
ロード・バランシング	LDBAL	RESOURCES	ロード・バランシングを有効にするかどうかを示すフラグ。ロード・バランシングが有効になっている場合、BEA Tuxedo システムは要求の負荷をネットワークで分散します。
	NETLOAD	MACHINES	呼び出し元クライアントからの要求をリモートに送る場合に、サービスのロード・ファクタに追加される数値。リモート・サーバ上でローカル・サーバを選択する際の基準になります。ロード・バランシングが有効になっていること (LDBAL に Y が設定されていること) が必要です。
	LOAD	SERVICES	サービス・インスタンスに対応付けられた相対的なロード・ファクタ。デフォルト値は 50 です。
セキュリティ	AUTHSVC	RESOURCES	システムに参加している各クライアントに対して、システムによって呼び出されるアプリケーション認証サービスの名前。
	SECURITY	RESOURCES	実行するアプリケーション・セキュリティの種類。
会話型通信	MAXCONV	RESOURCES	特定のマシン上で同時に関与できる会話の最大数。0 〜 32,767 の値を指定します。SERVERS セクションに会話型サーバが定義されている場合、デフォルト値は 64 になります。それ以外の場合、デフォルト値は 1 になります。このパラメータに指定された値は、MACHINES セクションのマシンごとに上書きできます。
	CONV	SERVERS	会話型通信がサポートされているかどうかを示す値。このパラメータが N に設定されているか、値が指定されてない場合、サービスに対する tpconnect() の呼び出しは失敗します。
	MIN/MAX	SERVERS	tmboot(1) によって起動するサーバのオカレンスの最小数と最大数。指定がない場合には、MIN と MAX はそれぞれ、1 と MIN がデフォルト値となります。要求/応答型サーバでも同じパラメータを利用できます。ただし、会話型サーバは、必要に応じて自動的に追加されます。そのため、MIN=1、MAX=10 と設定されている場合、tmboot によって最初に 1 つのサーバが起動します。そのサーバが提供するサービスに対して tpconnect() が呼び出されると、システムによって 2 番目のサーバが起動します。同じように、新しいサーバが上限の 10 まで起動します。
トランザクション管理	AUTOTRAN	SERVICES	サービス・ルーチンでトランザクション・モードを開始するかどうかを示す値。このパラメータに Y が設定されている場合、別のプロセスから要求メッセージを受信すると、サービス・サブルーチンでトランザクションが自動的に開始します。
	MAXTRANTIME	RESOURCES	この BEA Tuxedo アプリケーションで開始または受信されるトランザクションの最大許容タイムアウトを秒単位で指定します。
マルチスレッド・サーバ	MAXDISPATCHTHREADS	SERVERS	各サーバ・プロセスによってスレッドが追加された場合、同時にディスパッチされるスレッドの最大数。
	MINDISPATCHTHREADS	SERVERS	最初のサーバの起動時に開始されるサーバ・ディスパッチ・スレッドの数。

コンフィギュレーション・ファイルは、オペレーティング・システムのテキスト・ファイルです。このファイルを実際にシステムで使用する場合は、tmloadcf(1) を実行して、バイナリ・ファイルに変換する必要があります。

関連項目

• 『BEA Tuxedo アプリケーションの設定』

• 『BEA Tuxedo のファイル形式とデータ記述方法』の UBBCONFIG(5)

 

---

環境変数の設定

アプリケーション管理者は、最初にアプリケーションの実行環境を定義する変数を設定します。これらの環境変数を設定するには、UBBCONFIG ファイルの MACHINES セクションで ENVFILE パラメータに値を指定します。詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

アプリケーションのクライアント・ルーチンとサーバ・ルーチンに対して、既存の環境変数を更新したり、新しい変数を作成することができます。次の表は、よく使用される環境変数を示しています。変数は機能別に分類されています。

表 2-2 プログラミング関連の環境変数 (機能別)

機能	環境変数	定義内容 . .	使用先 . .
グローバル	TUXDIR	BEA Tuxedo システムのバイナリ・ファイルの場所。	BEA Tuxedo アプリケーション・プログラム
コンフィギュレーション	TUXCONFIG	BEA Tuxedo コンフィギュレーション・ファイルの場所。	BEA Tuxedo アプリケーション・プログラム
コンパイル	CC	C コンパイラを呼び出すコマンド。デフォルト値は cc です。	buildclient(1) コマンド、buildserver(1) コマンド
	CFLAGS	C コンパイラに渡すリンクのフラグ。このフラグは必須ではありません。	buildclient(1) コマンド、buildserver(1) コマンド
データ圧縮	TMCMPPRFM	圧縮レベル (1 〜 9)。	データ圧縮を行う BEA Tuxedo アプリケーション・プログラム
ロード・バランシング	TMNETLOAD	リモート・キューの負荷値に加算される数値。この値を指定すると、リモート・キューに実際より多くの作業負荷があるように設定できます。その結果、ロード・バランシングが有効になっていても、ローカル要求がリモート・キューよりローカル・キューに送られるようになります。	ロード・バランシングを実行する BEA Tuxedo アプリケーション・プログラム
バッファ管理	FIELDTBLS または FIELDTBLS32	FML および FML32 型付きバッファのフィールド・テーブル・ファイル名のカンマ区切りのリスト。FML および VIEW でのみ必要です。	FML 型付きバッファ、FML32 型付きバッファ、FML VIEW
	FLDTBLDIR または FLDTBLDIR32	FML および FML32 のフィールド・テーブル・ファイルが検索されるディレクトリのコロン区切りのリスト。Windows 2000 では、セミコロンで区切られます。	FML 型付きバッファ、FML32 型付きバッファ、FML VIEW
	VIEWFILES または VIEWFILES32	VIEW および VIEW32 型付きバッファで使用できるファイル名のカンマ区切りのリスト。	VIEW 型付きバッファ、VIEW32 型付きバッファ
	VIEWDIR または VIEWDIR32	VIEW および VIEW32 ファイルが検索されるディレクトリのコロン区切りのリスト。Windows 2000 では、セミコロンで区切られます。	VIEW 型付きバッファ、VIEW32 型付きバッファ
コード・セット符号化変換	TPMBENC	MBSTRING 型付きバッファ、または FML32 型付きバッファ内の FLD_MBSTRING フィールドに含めるコード・セット符号化名。	MBSTRING 型付きバッファ、FML32 型付きバッファ
	TPMBACONV	受信側プロセスでの受信時に、MBSTRING データまたは FML32 型付きバッファ内の FLD_MBSTRING フィールド・データの符号化を変換するかどうかを指定する、非 NULL 値または NULL 値。	MBSTRING 型付きバッファ、FML32 型付きバッファ
外部 DTD、スキーマ、およびエンティティ・ファイルのキャッシュ	URLENTITYCACHING	外部参照ファイル (DTD、スキーマ、エンティティ参照) のキャッシュの有効/無効を切り替えるフラグ。	XML ファイルを解析する BEA Tuxedo アプリケーション・プログラム
	URLENTITYCACHEDIR	キャッシュするファイルを格納するディレクトリの絶対パス。URLENTITYCACHING フラグが有効になっており、パスが指定されない場合、キャッシュされるファイルの格納先は (適切なパーミッションが設定されている) 現在の作業ディレクトリになります。	XML ファイルを解析する BEA Tuxedo アプリケーション・プログラム

UNIX 環境では、環境変数 PATH に $TUXDIR/bin を追加して、アプリケーションが BEA Tuxedo システムのコマンドに対する実行可能ファイルを見つけられるようにします。環境設定の詳細については、『BEA Tuxedo アプリケーションの設定』を参照してください。

関連項目

• 『BEA Tuxedo アプリケーションの設定』

• FML を使用した BEA Tuxedo アプリケーションのプログラミングの3-1 ページの「FML および VIEWS の環境設定」

 

---

必要なヘッダ・ファイルのインクルード

次の表は、#include 文を使用して、アプリケーション・プログラム内で指定する必要があるヘッダ・ファイルを示しています。これらのヘッダ・ファイルを使用すると、BEA Tuxedo システムと正しくインターフェイスをとることができるようになります

表 2-3 必要なヘッダ・ファイル

プログラム . .	ヘッダ・ファイル . .
すべての BEA Tuxedo アプリケーション・プログラム	BEA Tuxedo システムで提供される atmi.h ヘッダ・ファイル
FML 型付きバッファが使用されるアプリケーション・プログラム	対応するフィールド・テーブル・ファイルから生成されるヘッダ・ファイル BEA Tuxedo システムで提供される fml.h ヘッダ・ファイル
VIEW 型付きバッファが使用されるアプリケーション・プログラム	対応する VIEW 記述ファイルから生成されるヘッダ・ファイル

 

---

アプリケーションの起動と停止

アプリケーションを起動するには、tmboot(1) コマンドを実行します。このコマンドは、アプリケーションに必要な IPC 資源を確保し、管理プロセスとアプリケーション・サーバを起動します。