CORBA アプリケーションの分散

表 3-1 は、クライアント要求がサーバにルーティングされるしくみを説明します。この例では、bankapp と呼ばれる銀行取引アプリケーションでデータ依存型ルーティングが使用されています。bankapp には、3 つのグループ (BANKB1、BANKB2、および BANKB3) と、2 つのルーティング基準 (Account_ID および Branch_ID) があります。サービス WITHDRAW、DEPOSIT、および INQUIRY は、Account_ID フィールドを使用してルーティングされます。サービス OPEN および CLOSE は、Branch_ID フィールドを使用してルーティングされます。

表 3-1 サンプル分散アプリケーションのデータ依存型ルーティング

サーバ・グループ	ルーティング基準	サービス
BANKB1	Account_ID: 10000 - 49999	WITHDRAW、DEPOSIT、および INQUIRY
BANKB1	Branch_ID: 1 - 4	OPEN および CLOSE
BANKB2	Account_ID: 50000 - 79999	WITHDRAW、DEPOSIT、および INQUIRY
BANKB2	Branch_ID: 5 - 7	OPEN および CLOSE
BANKB3	Account_ID: 80000 - 109999	WITHDRAW、DEPOSIT、および INQUIRY
BANKB3	Branch_ID: 8 - 10	OPEN および CLOSE

リスト3-1 は、BEA Tuxedo システムでデータ依存型ルーティングを実現するためのコンフィギュレーション・ファイルにおける、GROUPS、SERVICES、および ROUTING の各セクションを含む UBBCONFIG ファイルの例を示します。

*GROUPS
BANKB1 GRPNO=1
BANKB2 GRPNO=2
BANKB3 GRPNO=3
#
*SERVICES
WITHDRAW ROUTING=ACCOUNT_ID
DEPOSIT ROUTING=ACCOUNT_ID
INQUIRY ROUTING=ACCOUNT_ID
OPEN_ACCT ROUTING=BRANCH_ID
CLOSE_ACCT ROUTING=BRANCH_ID
#
*ROUTING
ACCOUNT_ID FIELD=ACCOUNT_ID BUFTYPE=”FML”
RANGES=”MIN - 9999:*,
10000-49999:BANKB1,
50000-79999:BANKB2,
80000-109999:BANKB3,
*:*”
BRANCH_ID FIELD=BRANCH_ID BUFTYPE=”FML”
RANGES=”MIN - 0:*,
1-4:BANKB1,
5-7:BANKB2,
8-10:BANKB3,
*:*”

表 3-2 GROUPS セクションで指定されるパラメータ

パラメータ	説明
LMID	このサーバ・グループがこの特定のマシン上で実行されることを示すには、LMID を MACHINES セクションに割り当てる必要があります。値の後に、カンマで区切って別の LMID を指定し、代替マシンを設定することもできます。MIGRATE オプションが指定されている場合は、サーバ・グループをこの代替マシンに移行できます。グループ内のサーバを移行するには、RESTART=Y を指定する必要があります。
GRPNO	このサーバ・グループにグループ番号を示す数値を関連付けます。0 より大きく、30000 未満の番号を指定する必要があります。番号は、このコンフィギュレーション・ファイルの GROUPS セクションのエントリの中で一意でなければなりません(必須)。
TMSNAME	このサーバ・グループに関連付けるトランザクション管理サーバ (TMS) を指定します。
TMSCOUNT	このサーバ・グループ用に起動する TMSNAME のコピー数を指定します。最小値は 2 です。値を指定しない場合は、デフォルトの 3 が指定されます。サーバ・グループ用に起動された TMSNAME サーバはすべて、MSSQ セットで自動的に設定されます(省略可能)。
OPENINFO	特定のリソース・マネージャの特定のインスタンスを開くために必要な情報を指定するか、またはそのような情報がこのサーバ・グループには不要であることを示します。リソース・マネージャを OPENINFO パラメータで指定した場合、データベース名やアクセス・モードなどの情報が含まれます。値の文字列全体を 256 文字以下とし、二重引用符で囲む必要があります。OPENINFO 文字列の形式は、基となるリソース・マネージャのベンダごとに異なります。ベンダ固有の文字列の先頭は、rm_name: となります。これはベンダのトランザクション・インターフェイス (XA インターフェイス) の公開名の直後にコロン (:) を付けたものです。 TMSNAME が設定されていないか、TMS に設定されている場合、OPENINFO パラメータは無視されます。TMSNAME が設定されているが、OPENINFO 文字列の設定がヌル文字列 ("") になっている場合、またはこのパラメータがエントリ内に登場しない場合は、グループのリソース・マネージャが存在しているが、open オペレーションを実行するための情報を必要としていないことを意味します。
CLOSEINFO	データベースを閉じるときにリソース・マネージャが必要とする情報を指定します。このパラメータは省略することも、ヌル文字列を指定することもできます。デフォルト値はヌル文字列です。

表 3-4 では、SERVICES セクションのパラメータを説明します。

表 3-3 SERVICES セクションで指定されるパラメータ

パラメータ	説明
AUTOTRAN	このサービスで受信されたメッセージが既にトランザクション・モードではない場合に、自動的にトランザクションを開始するかどうかを判断します。デフォルト値は、N です。このパラメータの使用については、アプリケーションのサービスをコーディングするプログラマとの間で調整を行ってください。
TRANTIME	このサービスで自動的に開始されたトランザクションの、タイムアウト値を秒単位で指定します。デフォルト値は 30 秒です。これを指定するのは、AUTOTRAN=Y や、ほかのタイムアウト値が必要な場合のみです。

パラメータ

説明

AUTOTRAN

このサービスで受信されたメッセージが既にトランザクション・モードではない場合に、自動的にトランザクションを開始するかどうかを判断します。デフォルト値は、N です。このパラメータの使用については、アプリケーションのサービスをコーディングするプログラマとの間で調整を行ってください。

TRANTIME

このサービスで自動的に開始されたトランザクションの、タイムアウト値を秒単位で指定します。デフォルト値は 30 秒です。これを指定するのは、AUTOTRAN=Y や、ほかのタイムアウト値が必要な場合のみです。

表 3-4 では、INTERFACES セクションのパラメータを説明します。

表 3-4 INTERFACES セクションで指定されるパラメータ

パラメータ	説明
FACTORYROUTING = criterion-name	この BEA Tuxedo CORBA インターフェイスのファクトリ・ベース・ルーティングに使用されるルーティング基準名を指定します。ファクトリ・ベース・ルーティングを要求するインターフェイスに対しては、 FACTORYROUTING パラメータを指定する必要があります。
AUTOTRAN	このインターフェイスで受信されたメッセージが既にトランザクション・モードではない場合に、自動的にトランザクションを開始するかどうかを判断します。デフォルト値は、N です。このパラメータの使用については、アプリケーションの ICF ファイルの transaction policy オプションの設定とパラメータが一致するように、アプリケーションのインターフェイスをコーディングするプログラマとの間で調整を行ってください。
TRANTIME	このインターフェイスで自動的に開始されたトランザクションの、タイムアウト値を秒単位で指定します。デフォルト値は 30 秒です。これを指定するのは、AUTOTRAN=Y およびデフォルト以外のタイムアウト値が必要な場合のみです。
LOAD = number	CORBA インターフェイスがシステムに与えると予想される相対的な負荷を表す、1 から 100 の間の任意の数値を指定します。数の設定スキーマは、このアプリケーションで使用されるほかの CORBA インターフェイスに割り当てられた LOAD 数値を基準としています。デフォルト値は 50 です。BEA Tuxedo システムは、要求のルーティング先として最適なサーバを選択するためにこの数字を使用します。

"IDL:beasys.com/UniversityP/Registrar:1.0"
FACTORYROUTING = STU_ID
AUTOTRAN=Y
TRANTIME=50

"IDL:beasys.com/BillingP/Teller:1.0"
FACTORYROUTING = ACT_NUM
AUTOTRAN=Y

リスト3-4 は、Production サンプル・アプリケーションでファクトリ・ベース・ルーティングに使用される UBBCONFIG ファイルの ROUTING セクションを示します。

*ROUTING

STU_ID
FIELD = "student_id"
TYPE = FACTORY
FIELDTYPE = LONG
RANGES = "100001-100005:ORA_GRP1,100006-100010:ORA_GRP2"

ACT_NUM
FIELD = "account_number"
TYPE = FACTORY
FIELDTYPE = LONG
RANGES = "200010-200014:APP_GRP1,200015-200019:APP_GRP2"

表 3-5 では、DM_ROUTING セクションのパラメータを説明します。

表 3-5 DM_ROUTING セクションで指定されるパラメータ

パラメータ	説明
FIELD = identifier	ルーティング・フィールドの名前を指定します。長さは 30 文字以下です。このフィールドは、FML フィールド・テーブルで識別されたフィールド名 (FML バッファの場合)、または FML VIEW テーブルで識別されたフィールド名 (VIEW、X_C_TYPE、または X_COMMON バッファの場合) と見なされます。FLDTBLDIR 環境変数および FIELDTBLS 環境変数は FML フィールド・テーブルを見つけるために使用され、 VIEWDIR 環境変数および VIEWFILES 環境変数は、FML VIEW テーブルを見つけるために使用されます。FML32 バッファ内のフィールドがルーティングに使用される場合は、8191 以下の数値をフィールド番号として指定します。
BUFTYPE = "type1[:subtype1[,subtype2 . . . ]][;type2[:subtype3[, . . . ]]] . . ."	このルーティング・エントリで有効なデータ・バッファのタイプとサブタイプのリストを指定します。有効なタイプは、FML、VIEW、X_C_TYPE、および X_COMMON に限定されます。タイプ FML ではサブタイプは指定されません。それ以外のタイプにはサブタイプが必要です。ただし * は使用できません。タイプとサブタイプのペアのうち、重複するものは同じルーティング基準名として指定できません。タイプとサブタイプのペアが一意の場合、複数のルーティング・エントリは同じ基準名を持つことができます。これは必須パラメータです。単一のルーティング・エントリに複数のバッファ・タイプが指定される場合、各バッファ・タイプに対するルーティング・フィールドのデータ型は同じでなければなりません。フィールド値が設定されていないか (FML バッファの場合)、または特定の範囲と一致しておらず、ワイルドカードの範囲が指定されていない場合、リモート・サービスの実行を要求したアプリケーション・プロセスに対してエラーが返されます。CORBA および EJB では、ルーティングは許可されていません。TGIOPは有効なバッファ型ではありません。
RANGES ="range1:rdom1[,range2:rdom2 ...]"	ルーティング・フィールドの範囲と関連付けられたリモート・ドメイン名 (RDOM) を指定します。文字列は二重引用符で囲み、range/RDOM のペアをカンマで区切って順番に並べた形式にします。範囲は、単一の値 (符号付き数値または一重引用符で囲んだ文字列)、または、lower - upper (lowerと upper は共に符号付き数値または一重引用符で囲んだ文字列) の形式で表します。lower には、upper 以下の値を設定します。文字列値に一重引用符を埋め込むには、一重引用符の前にバックスラッシュを 2 つ挿入します。たとえば、「O'Brien」は「O¥¥'Brien」になります。関連する FIELD のデータ型の最小値を示すには、MIN を使用します。文字列と carray の最小値にはヌル文字列を指定します。文字フィールドの最小値には、0 を指定します。数値の場合、これはフィールドに格納できる最小値です。関連する FIELD のデータ型の最大値を示すには、MAX を使用します。文字列と carray の最大値には、8 進数値の 255 文字の無限文字列を指定します。文字フィールドの最大値には、単一の 8 進数値の 255 文字を指定します。数値の場合は、数値としてフィールドに格納できる最大値です。したがって、MIN - -5 は -5 以下のすべての数を表し、6 - MAX は 6 以上のすべての数を表します。範囲 (range) 内のメタキャラクタ * (ワイルドカード) は、既にエントリとして指定した範囲では使用されなかった任意の値を示します。各エントリでは 1 つのワイルドカードによる範囲指定だけが可能です。* は最後に指定します。続けて範囲を指定すると無視されます。

パラメータ

説明

FIELD = identifier

ルーティング・フィールドの名前を指定します。長さは 30 文字以下です。このフィールドは、FML フィールド・テーブルで識別されたフィールド名 (FML バッファの場合)、または FML VIEW テーブルで識別されたフィールド名 (VIEW、X_C_TYPE、または X_COMMON バッファの場合) と見なされます。FLDTBLDIR 環境変数および FIELDTBLS 環境変数は FML フィールド・テーブルを見つけるために使用され、 VIEWDIR 環境変数および VIEWFILES 環境変数は、FML VIEW テーブルを見つけるために使用されます。FML32 バッファ内のフィールドがルーティングに使用される場合は、8191 以下の数値をフィールド番号として指定します。

BUFTYPE = "type1[:subtype1[,subtype2 . . . ]][;type2[:subtype3[, . . . ]]] . . ."

このルーティング・エントリで有効なデータ・バッファのタイプとサブタイプのリストを指定します。有効なタイプは、FML、VIEW、X_C_TYPE、および X_COMMON に限定されます。

タイプ FML ではサブタイプは指定されません。それ以外のタイプにはサブタイプが必要です。ただし * は使用できません。

タイプとサブタイプのペアのうち、重複するものは同じルーティング基準名として指定できません。タイプとサブタイプのペアが一意の場合、複数のルーティング・エントリは同じ基準名を持つことができます。これは必須パラメータです。

単一のルーティング・エントリに複数のバッファ・タイプが指定される場合、各バッファ・タイプに対するルーティング・フィールドのデータ型は同じでなければなりません。フィールド値が設定されていないか (FML バッファの場合)、または特定の範囲と一致しておらず、ワイルドカードの範囲が指定されていない場合、リモート・サービスの実行を要求したアプリケーション・プロセスに対してエラーが返されます。CORBA および EJB では、ルーティングは許可されていません。TGIOPは有効なバッファ型ではありません。

RANGES ="range1:rdom1[,range2:rdom2 ...]"

ルーティング・フィールドの範囲と関連付けられたリモート・ドメイン名 (RDOM) を指定します。文字列は二重引用符で囲み、range/RDOM のペアをカンマで区切って順番に並べた形式にします。

範囲は、単一の値 (符号付き数値または一重引用符で囲んだ文字列)、または、lower - upper (lowerと upper は共に符号付き数値または一重引用符で囲んだ文字列) の形式で表します。lower には、upper 以下の値を設定します。文字列値に一重引用符を埋め込むには、一重引用符の前にバックスラッシュを 2 つ挿入します。たとえば、「O'Brien」は「O¥¥'Brien」になります。

関連する FIELD のデータ型の最小値を示すには、MIN を使用します。文字列と carray の最小値にはヌル文字列を指定します。文字フィールドの最小値には、0 を指定します。数値の場合、これはフィールドに格納できる最小値です。

関連する FIELD のデータ型の最大値を示すには、MAX を使用します。文字列と carray の最大値には、8 進数値の 255 文字の無限文字列を指定します。文字フィールドの最大値には、単一の 8 進数値の 255 文字を指定します。数値の場合は、数値としてフィールドに格納できる最大値です。

したがって、MIN - -5 は -5 以下のすべての数を表し、6 - MAX は 6 以上のすべての数を表します。

範囲 (range) 内のメタキャラクタ * (ワイルドカード) は、既にエントリとして指定した範囲では使用されなかった任意の値を示します。各エントリでは 1 つのワイルドカードによる範囲指定だけが可能です。* は最後に指定します。続けて範囲を指定すると無視されます。

リスト3-5 は、5 サイトのドメイン・コンフィギュレーションを定義するコンフィギュレーション・ファイルを示します。Central Bank Branch と通信する、4 つの銀行支店ドメインがあります。銀行支店のうち、3 つがほかの BEA Tuxedo システム・ドメイン内で実行されています。残りの支店は、別の TP ドメインの制御下で実行されており、そのドメインとの通信には OSI-TP が使用されています。この例では、Central Bank から見た BEA Tuxedo のドメイン・ゲートウェイ・コンフィギュレーション・ファイルを示しています。DM_TDOMAIN セクションは、b01 をミラーリングしたゲートウェイを例示しています。

# Central Bank 用の BEA Tuxedo ドメイン・コンフィギュレーション・ファイル
#
#
*DM_LOCAL_DOMAINS
# <local domain name> <Gateway Group name> <domain type> <domain id> <log device>
# [<audit log>] [<blocktime>]
# [<log name>] [<log offset>] [<log size>]
# [<maxrdom>] [<maxrdtran>] [<maxtran>]
# [<maxdatalen>] [<security>]
# [<tuxconfig>] [<tuxoffset>]

#
#
DEFAULT: SECURITY = NONE
c01 GWGRP = bankg1
TYPE = TDOMAIN
DOMAINID = "BA.CENTRAL01"
DMTLOGDEV = "/usr/apps/bank/DMTLOG"
DMTLOGNAME = "DMTLG_C01"
c02 GWGRP = bankg2
TYPE = OSITP
DOMAINID = "BA.CENTRAL01"
DMTLOGDEV = "/usr/apps/bank/DMTLOG"
DMTLOGNAME = "DMTLG_C02"
NWDEVICE = "OSITP"
URCH = "ABCD"
#
*DM_REMOTE_DOMAINS
#<remote domain name> <domain type> <domain id>
#
b01 TYPE = TDOMAIN
DOMAINID = "BA.BANK01"
b02 TYPE = TDOMAIN
DOMAINID = "BA.BANK02"
b03 TYPE = TDOMAIN
DOMAINID = "BA.BANK03"
b04 TYPE = OSITP
DOMAINID = "BA.BANK04"
URCH = "ABCD"
#
*DM_TDOMAIN
#
# <local or remote domainname> <network address> [nwdevice]
#
# Local network addresses
c01 NWADDR = "//newyork.acme.com:65432" NWDEVICE ="/dev/tcp"
c02 NWADDR = "//192.76.7.47:65433" NWDEVICE ="/dev/tcp"
# Remote network addresses: second b01 specifies a mirrored gateway
b01 NWADDR = "//192.11.109.5:1025" NWDEVICE = "/dev/tcp"
b01 NWADDR = "//194.12.110.5:1025" NWDEVICE = "/dev/tcp"
b02 NWADDR = "//dallas.acme.com:65432" NWDEVICE = "/dev/tcp"
b03 NWADDR = "//192.11.109.156:4244" NWDEVICE = "/dev/tcp"
#
*DM_OSITP
#
#<local or remote domain name> <apt> <aeq>
# [<aet>] [<acn>] [<apid>] [<aeid>]
# [<profile>]
#
c02 APT = "BA.CENTRAL01"
AEQ = "TUXEDO.R.4.2.1"
AET = "{1.3.15.0.3},{1}"
ACN = "XATMI"
b04 APT = "BA.BANK04"
AEQ = "TUXEDO.R.4.2.1"
AET = "{1.3.15.0.4},{1}"
ACN = "XATMI"
*DM_LOCAL_SERVICES
#<service_name> [<Local Domain name>] [<access control>] [<exported svcname>]
# [<inbuftype>] [<outbuftype>]
#

open_act ACL = branch
close_act ACL = branch
credit
debit
balance
loan LDOM = c02 ACL = loans
*DM_REMOTE_SERVICES
#<service_name> [<Remote domain name>] [<local domain name>]
# [<remote svcname>] [<routing>] [<conv>]
# [<trantime>] [<inbuftype>] [<outbuftype>]
#
tlr_add LDOM = c01 ROUTING = ACCOUNT
tlr_bal LDOM = c01 ROUTING = ACCOUNT
tlr_add RDOM = b04 LDOM = c02 RNAME ="TPSU002"
tlr_bal RDOM = b04 LDOM = c02 RNAME ="TPSU003"
*DM_ROUTING
# <routing criteria> <field> <typed buffer> <ranges>
#
ACCOUNT FIELD = branchid BUFTYPE ="VIEW:account"
RANGES ="MIN - 1000:b01, 1001-3000:b02, *:b03"
*DM_ACCESS_CONTROL
#<acl name> <Remote domain list>
#
branch ACLIST = b01, b02, b03
loans ACLIST = b04