Oracle Tuxedoアプリケーションの設定

トランザクション対応のATMIアプリケーションの構成

このトピックには次の項が含まれます:

UBBCONFIGファイルをATMIトランザクションに対応させて変更する

トランザクションに対応させるには、次に示すようにアプリケーションのUBBCONFIGファイルのRESOURCES、MACHINES、GROUPSおよびSERVICESセクションを変更する必要があります。

RESOURCESセクションでグローバル・トランザクションのパラメータを指定する

次の表では、RESOURCESセクションに指定するトランザクション関連のパラメータを説明します。

MACHINESセクションでトランザクション・ログ(TLOG)を作成する

TLOGを作成するには、以下のタスクを実行します。

UDLを作成する

汎用デバイス・リスト(UDL : Universal Device List)は、Oracle Tuxedoファイル・システムの地図のようなものです。UDLは、アプリケーションの起動後、共有メモリーにロードされます。TLOGは、トランザクションが終了するまで、トランザクションに関する情報が保持されているログを参照します。UDL内にTLOGデバイス用のエントリを作成するには、グローバル・トランザクションを使用して各マシンにUDLを作成します。(TLOGDEVICEが2台のマシン間でミラーリングされる場合、対になるマシンでこれを行う必要はありません。)BBLは、起動時にTLOGを初期化して開きます。

UDLを作成するには、アプリケーションを起動する前に次のコマンドを実行します。

tmadmin -c crdl -z config -b blocks

configの値は、UDLの作成先デバイスのフルパス名です。これは、構成ファイルのMACHINESセクションにあるTLOGDEVICEパラメータの値と一致している必要があります。blocksには、デバイス上に割り当てるブロックの数を指定します。

TLOGの保存方法については、『Oracle Tuxedoシステムのインストール』を参照してください。

MACHINESセクションでトランザクション関連のパラメータを定義する

グローバル・トランザクション・ログ(TLOG)を定義するには、UBBCONFIGファイルのMACHINESセクションでパラメータをいくつか設定する必要があります。

これらのパラメータのうち、TLOGDEVICEについては、TLOGが必要な各マシン上にTLOGDEVICEのデバイス・リスト・エントリを手動で作成しなければなりません。これは、TUXCONFIGがロードされる前でも後でも作成できますが、必ず、システムを起動する前に作成してください。

次の表では、MACHINESセクションに指定するトランザクション関連のパラメータを説明します。

Oracle DatabaseへのTLOGの書込み

Oracleデータベースにtlogを書き込む場合、UDLを作成する必要はありません。
次の手順を実行する必要があります。

Domainsトランザクション・ログを作成する

Domainsゲートウェイ・グループを起動する前に、Domainsトランザクション・ログを作成する必要があります。Domainsトランザクション・ログは、現在のマシン(DMADMを実行中のマシン)の指定されたローカル・ドメインに作成してください。ログを作成するには、次のコマンドを入力します。

dmadmin crdmlog crdlog -d local_domain_name

このコマンドでは、DMCONFIGファイルで指定したパラメータが使用されます。指定したローカル・ドメインが現在のマシン上でアクティブであるか、またはログがすでに存在する場合、このコマンドは失敗します。トランザクション・ログがない場合は、Domainsゲートウェイ・グループの起動時に作成されます。

関連項目

GROUPSセクションでリソース・マネージャとトランザクション・マネージャ・サーバーを定義する

GROUPSセクションのパラメータにより、特定のグループに対してトランザクション・マネージャ・サーバー(TMS)およびリソース・マネージャ(RM)の属性を定義できます。

GROUPSセクションの例

以下は、Oracle Tuxedoシステムに同梱されている銀行業務サンプル・アプリケーションbankappのGROUPSセクションの例です。

BANKB1 GRPNO=1 TMSNAME=TMS_SQL TMSCOUNT=2
OPENINFO=”TUXEDO/SQL:APPDIR/bankdl1:bankdb:readwrite”

GROUPSセクションの例でのトランザクション値

次の表では、GROUPSセクションの例のトランザクション値を説明します。

TMSNAME、TMSCOUNT、OPENINFO、およびCLOSEINFOパラメータの特性

次の表では、TMSNAME、TMSCOUNT、OPENINFO、およびCLOSEINFOパラメータの特性を説明します。

SERVICESセクションでサービスに対するトランザクションの開始を有効にする

状況によっては、SERVICESセクションにAUTOTRAN、TRANTIME、およびROUTINGという3つのトランザクション関連パラメータを設定しなければならない場合があります。

AUTOTRAN、TRANTIME、およびROUTINGパラメータの特性

次の表では、AUTOTRAN、TRANTIME、およびROUTINGパラメータの特性を説明します。

トランザクションをサポートするようにDomains構成ファイルを変更する

ドメインを介してトランザクションを有効にするには、Domains構成ファイル(DMCONFIG)のDM_LOCALおよびDM_IMPORTセクション内のパラメータを設定する必要があります。DM_LOCALセクションのエントリでは、ローカル・ドメインの特性を定義します。DM_IMPORTセクションのエントリでは、インポートされたサービスや、リモート・ドメインで使用可能なサービスを定義します。

DMTLOGDEV、DMTLOGNAME、DMTLOGSIZE、MAXRAPTRAN、およびMAXTRANパラメータの特性

Domains構成ファイルのDM_LOCALセクションでは、ローカル・ドメインおよびそれに関連するゲートウェイ・グループを指定します。ゲートウェイ・グループ(ローカル・ドメイン)ごとに、そのグループで実行するドメイン・ゲートウェイ・プロセスに必要なパラメータを指定するエントリを作成する必要があります。

次の表では、このセクションの5つのトランザクション関連パラメータ(DMTLOGDEV、DMTLOGNAME、DMTLOGSIZE、MAXRAPTRAN、およびMAXTRAN)を説明します。

AUTOTRANおよびTRANTIMEパラメータの特性

Domains構成ファイルのDM_IMPORTセクションでは、インポートされ、リモート・ドメインで使用可能になったサービスに関する情報を提供します。各リモート・サービスは、特定のリモート・ドメインに関連付けられています。

DM_IMPORTセクションに、トランザクションをサポートするAUTOTRANパラメータとTRANTIMEパラメータを設定することもできます。次の表では、これらのパラメータを説明します。

UBBCONFIGファイルのRESOURCESセクションでは、MAXTRANTIMEという追加のトランザクション・タイムアウト・プロパティも使用できます。MAXTRANTIMEタイムアウト値がTRANTIMEタイムアウト値またはトランザクションを開始するtpbegin(3c)の呼出しで渡されたタイムアウト値より小さい場合、トランザクションのタイムアウトはMAXTRANTIMEの値に削減されます。MAXTRANTIMEはOracle Tuxedo 8.0以前を実行するマシン上で開始されるトランザクションには影響を与えません。ただし、Oracle Tuxedo 8.1以降を実行するマシンがトランザクションの影響を受ける場合は、そのノードに対して構成されているMAXTRANTIME値までトランザクション・タイムアウト値が制限(必要に応じて減少)されます。

Domains構成の場合は、以下のようなトランザクション処理のシナリオが考えられます。

MAXTRANTIMEの詳細は、UBBCONFIG(5)のRESOURCESセクションにあるMAXTRANTIME、またはTM_MIB(5)のT_DOMAINクラスにあるTA_MAXTRANTIMEを参照してください。

例:トランザクションを使用する分散アプリケーション

この項では、3つのサイトに分散される、トランザクション対応のbankappアプリケーションを定義する構成ファイル例を示します。このアプリケーションには、次の特徴があります。

ファイルは、7つのセクション(RESOURCES、MACHINES、GROUPS、NETWORK、SERVERS、SERVICES、およびROUTING)で構成されます。

RESOURCESセクションの例

次のリストは、RESOURCESセクションの例です。

*RESOURCES
#
IPCKEY       99999
UID          1
GID          0
PERM         0660
MAXACCESSERS 25
MAXSERVERS   25
MAXSERVICES  40
MAXGTT       20
MASTER       SITE3, SITE1
SCANUNIT     10
SANITYSCAN   12
BBLQUERY     180
BLOCKTIME    30
DBBLWAIT     6
OPTIONS      LAN, MIGRATE
MODEL        MP
LDBAL        Y

このリストでは、次の点に注意してください。

MACHINESセクションの例

次のリストは、MACHINESセクションの例です。

*MACHINES
giselle      LMID=SITE1
             TUXDIR=”/usr/tuxedo”
             APPDIR=”/usr/home”
             ENVFILE=”/usr/home/ENVFILE”
             TLOGDEVICE=”/usr/home/TLOG”
             TLOGNAME=TLOG
             TUXCONFIG=”/usr/home/tuxconfig”
             TYPE=”3B600”

romeo        LMID=SITE2
             TUXDIR=”/usr/tuxedo”
             APPDIR=”/usr/home”
             ENVFILE=”/usr/home/ENVFILE”
             TLOGDEVICE=”/usr/home/TLOG”
             TLOGNAME=TLOG
             TUXCONFIG=”/usr/home/tuxconfig”
             TYPE=”SEQUENT”

juliet       LMID=SITE3
             TUXDIR=”/usr/tuxedo”
             APPDIR=’/usr/home”
             ENVFILE=”/usr/home/ENVFILE”
             TLOGDEVICE=”/usr/home/TLOG”
             TLOGNAME=TLOG
             TUXCONFIG=”/usr/home/tuxconfig”
             TYPE=”AMDAHL”

このリストでは、次の点に注意してください。

GROUPSセクションおよびNETWORKセクションの例

次のリストは、GROUPSセクションおよびNETWORKセクションの例です。

*GROUPS
DEFAULT:        TMSNAME=TMS_SQL       TMSCOUNT=2
BANKB1          LMID=SITE1            GRPNO=1
 OPENINFO=”TUXEDO/SQL:/usr/home/bankdl1:bankdb:readwrite”
BANKB2          LMID=SITE2            GRPNO=2
 OPENINFO=”TUXEDO/SQL:/usr/home/bankdl2:bankdb:readwrite”
BANKB3           LMID=SITE3            GRPNO=3
 OPENINFO=”TUXEDO/SQL:/usr/home/bankdl3:bankdb:readwrite”

*NETWORK
SITE1            NADDR=”0X0002ab117B2D4359”
                 BRIDGE=”/dev/tcp”
                 NLSADDR=”0X0002ab127B2D4359”

SITE2            NADDR=”0X0002ab117B2D4360”
                 BRIDGE=”/dev/tcp”
                 NLSADDR=”0X0002ab127B2D4360”

SITE3            NADDR=”0X0002ab117B2D4361”
                 BRIDGE=”/dev/tcp”
                 NLSADDR=”0X0002ab127B2D4361”

このリストでは、次の点に注意してください。

SERVERS、SERVICES、およびROUTINGセクションの例

次のリストは、SERVERS、SERVICES、およびROUTINGセクションの例です。

*SERVERS
DEFAULT: RESTART=Y MAXGEN=5 REPLYQ=N CLOPT=”-A”
TLR      SRVGRP=BANKB1    SRVID=1    CLOPT=”-A -- -T 100"
TLR      SRVGRP=BANKB2    SRVID=3    CLOPT=”-A -- -T 400"
TLR      SRVGRP=BANKB3    SRVID=4    CLOPT=”-A -- -T 700"
XFER     SRVGRP=BANKB1    SRVID=5    REPLYQ=Y
XFER     SRVGRP=BANKB2    SRVID=6    REPLYQ=Y
XFER     SRVGRP=BANKB3    SRVID=7    REPLYQ=Y

*SERVICES
DEFAULT:    AUTOTRAN=N
WITHDRAW        ROUTING=ACCOUNT_ID
DEPOSIT         ROUTING=ACCOUNT_ID
TRANSFER        ROUTING=ACCOUNT_ID
INQUIRY         ROUTING=ACCOUNT_ID

*ROUTING
ACCOUNT_ID      FIELD=ACCOUNT_ID     BUFTYPE=”FML”
                     RANGES=”MON - 9999:*,
                     10000 - 39999:BANKB1
                     40000 - 69999:BANKB2
                     70000 - 100000:BANKB3
                        “”

このリストでは、次の点に注意してください。

関連項目