|
bankappとは、Oracle Tuxedoソフトウェアに備わっているサンプルATMI銀行業務アプリケーションです。アプリケーションは、口座の開設および解約、口座の残高照会、口座への預金または口座からの引出し、ある口座から別の口座への振替えといった銀行教務を実行します。
このチュートリアルでは、bankappアプリケーションを開発して実行するための手順を順に示します。 このチュートリアルでbankappの「開発」を経験すると、独自のアプリケーションを開発できるようになります。
bankappチュートリアルは、次の3つの項から構成されています。
| 注意: | ここで説明する内容は、アプリケーションの開発、管理、プログラミングに経験のあるUNIXおよびWindows 2003システムのユーザーを対象としています。 また、Oracle Tuxedoソフトウェアについて理解していることを前提としています。 |
このサンプル・アプリケーションの手順は、UNIXまたはWindows 2003環境で動作するシェル・スクリプトRUNME.shとRUNME.cmdによって自動化されています。 対応するreadmeファイルに、これらのファイルの実行方法が説明されています。 これらのファイルに目をとおし実行の手順を十分に理解した上で、ここで説明する内容に従って操作をすれば、分散アプリケーションの設定と管理をよりスムーズに行うことができます。
bankappサンプル・アプリケーションでは、ソフトウェアに同梱のデモ版リレーショナル・データベースが使用されています。 サンプル・アプリケーションに用意されたデモ用の各種コマンドとSQLコードを使用して、データベースにアクセスします。
ここでは、bankappアプリケーションを構成するファイル、クライアントおよびサービスについて説明します。それぞれの詳細は、次のアクティビティのいずれかをクリックしてください。
bankappアプリケーションを構成するファイルは、bankappディレクトリに置かれています。このディレクトリは、次の図のように構成されています。

bankappディレクトリには、次のファイルが置かれています。
audit)AUDIT)auditcon)bankappをサンプル・アプリケーションとして実行するためのファイル 次の表は、銀行業務アプリケーションを構成するファイルを示しています。 Oracle Tuxedoソフトウェアに同梱のソース・ファイル、bankapp.mkの実行時に生成されるファイル、および各ファイルの簡単な説明がまとめられています。
bankcltファイルには、bankappアプリケーションからOracle Tuxedoサービスをリクエストするクライアント・プログラムが定義されています。このクライアント・プログラムはテキスト形式で、次のオプションが提供されています。
これらの各オプションは、アプリケーションの終了を除き、次のタスクを実行するサブルーチンを呼び出します:
注1かっこ内の数値は、そのフィールドでのFMLオカレンスの数です。
do_tpcall()関数(bankclt.cの447行で始まる)は次のとおりです:
/*
* This function does the tpcall to Tuxedo.
*/
static int
do_tpcall(char *service)
{
long len;
char *server_status;
/* Begin a Global transaction */
if (tpbegin(30, 0) == -1) {
(void)fprintf(stderr, "ERROR: tpbegin failed (%s)\n",
tpstrerror(tperrno));
return(-1);
}
/* Request the service with the user data */
if (tpcall(service, (char *)fbfr, 0, (char **)&fbfr, &len,
0) == -1) {
if(tperrno== TPESVCFAIL && fbfr != NULL &&
(server_status=Ffind(fbfr,STATLIN,0,0)) != 0) {
/* Server returned failure */
(void)fprintf(stderr, "%s returns failure
(%s)\n",
service,server_status);
}
else {
(void)fprintf(stderr,
"ERROR: %s failed (%s)\n", service,
tpstrerror(tperrno));
}
/* Abort the transaction */
(void) tpabort(0);
return(-1);
}
/* Commit the transaction */
if(tpcommit(0) < 0) {
(void)fprintf(stderr, "ERROR: tpcommit failed
(%s)\n",
tpstrerror(tperrno));
return(-1);
}
return(0);
}
tpbegin()を呼び出して、グローバル・トランザクションを開始します。これにより、すべての処理が1つの単位として実行されます。char *service)と割り当てられたFMLバッファ(グローバルな*fbfrポインタ)を渡して、tpcall()を呼び出します。tpcall()がサーバー・エラー(TPSVCERR)が原因で失敗すると、サーバーからのメッセージをSTATLIN FMLフィールドに出力します。 tpabort()を使用してトランザクションをロールバックし、-1を返します。tpcall()がほかのエラーが原因で失敗すると、そのエラー・メッセージを出力します。tpabort()を使用してトランザクションをロールバックし、-1を返します。tpcall()が正常に終了すると、tpcommit()を使用してトランザクションをコミットし、0を返します。| 注意: | unsolfcn()関数は、クライアントへの非請求メッセージがある場合に呼び出されます。 この関数では、STRING型バッファだけを使用でき、メッセージが出力されます。 |
bankappでは、Oracle Tuxedoプログラムud(1)が使用されます。ud(1)は、標準入力からフィールド化バッファを読み取り、それをサービスに送信します。 サンプル・アプリケーションでは、udはpopulateおよびdriverプログラムで使用されています。
auditは、ABAL、TBAL、ABAL_BID、およびTBAL_BIDサービスを使用して、銀行単位または支店単位で残高照会を行うリクエスト/レスポンス型のクライアント・プログラムです。このプログラムは、次の2とおりの方法で実行できます。
auditのソース・コードは、main()およびsum_bal()サブルーチンから構成されます。 Oracle TuxedoのATMI関数は、この両方で使用されます。 このプログラムでは、VIEW型バッファとaud.hヘッダー・ファイルで定義された構造体が使用されます。 構造体のソース・コードは、VIEW記述ファイルaud.vに記述されています。
次の擬似コードは、このプログラムのアルゴリズムを示しています。
main()
{
Parse command-line options with getopt();
Join application with tpinit();
Begin global transaction with tpbegin();
If (branch_ID specified) {
Allocate buffer for service requests with tpalloc();
Place branch_ID into the aud structure;
Do tpcall() to "ABAL_BID" or "TBAL_BID";
Print balance for branch_ID;
Free buffer with tpfree();
}
else /* branch_ID not specified */
all subroutine sum_bal();
Commit global transaction with tpcommit();
Leave application with tpterm();
}
sum_bal()
}
Allocate buffer for service requests with tpalloc();
For (each of several representative branch_ID's,
one for each site)
Do tpacall() to "ABAL" or "TBAL";
For (each representative branch_ID) {
Do tpgetrply() wtith TPGETANY flag set
to retrieve replies;
Add balance to total;
Print total balance;
}
Free buffer with tpfree();
}
以下は、auditソース・コードの構成要素であるmain()およびsum_bal()で行われる処理をまとめたものです。
auditconは、auditプログラムの会話型バージョンです。 auditconのソース・コードでは、会話型通信のためのATMI関数が使用されます。たとえば、クライアントとサーバー間の接続を確立するtpconnect()、メッセージを送信するtpsend()、メッセージを受信するtprecv()が使用されます。
次の擬似コードは、このプログラムのアルゴリズムを示しています。
main()
{
Join the application
Begin a transaction
Open a connection to conversational service AUDITC
Do until user says to quit: {
Query user for input
Send service request
Receive response
Print response on user's terminal
Prompt for further input
}
Commit transaction
Leave the application
}
bankmgrは、bankappの継続的に稼働するクライアントです。このプログラムは、新規口座の開設や$10,000以上の引き出しなど、アプリケーション定義のイベントで特に関心のあるものをサブスクライブします。bankmgr.cクライアントの詳細は、bankappのREADME2ファイル、またはbankmgr.cコードを参照してください。
サーバーとは、1つ以上のサービスを提供する実行可能プロセスです。Oracle Tuxedoシステムでは、サーバーはクライアントとして動作するプロセスから継続的にリクエストを受け取り、それを適切なサービスにディスパッチします。サービスとは、アプリケーションの処理を行うために記述されたC言語のサブルーチンです。Oracle Tuxedoアプリケーションは、サービスを提供し、リソース・マネージャにアクセスできるように作成されています。サービス・ルーチンは、Oracle Tuxedoアプリケーション・プログラマが作成します。
データベースと直接やり取りは行わないTRANSFERサービスを除くすべてのbankappサービスのコードは、C言語に埋め込み型SQL文が使用されています。 TRANSFERサービスは、XFERサーバーによって実行されるC言語プログラムです。つまり、ソース・ファイルは.ecファイルではなく.cファイルです。
bankappのすべてのbankappサービスでは、アプリケーション・トランザクション管理インタフェース(ATMI)を使用して、次のタスクを実行します。
bankappの5つのサーバーは、リクエスト/レスポンス・モードで動作します。このうちの4つは、埋め込み型SQL文を使用して、リソース・マネージャにアクセスします。これらのサーバーのソース・ファイル(bankappサンプル・アプリケーションのサブディレクトリにあります)には、ファイル名に拡張子として.ecが付いています。
5番目のサーバーXFERは振替えに使用されるサーバーで、リソース・マネージャ自体への呼出しは行いません。このサーバーは、TLRサーバーによって提供されるWITHDRAWALサービスおよびDEPOSITサービスを呼び出し、口座間の振替えを行います。 XFERでは、リソース・マネージャへの呼出しは行われず、埋め込み型SQL文が使用されていないので、XFERのソース・ファイルは.cファイルです。
AUDITCは、会話型サーバーの一例です。このサーバーでは、AUDITCと呼ばれるサービスが提供されます。会話型クライアントauditconは、AUDITCへの接続を確立し、そこに監査情報をリクエストします。
AUDITCはリクエストを評価し、必要な情報を得るために適切なサービス(ABAL、TBAL、ABAL_BID、またはTBAL_BID)を呼び出します。呼び出されたサービスから応答を受信すると、AUDITCはその応答をauditconに返します。会話型サーバーのサービスは、リクエスト/レスポンス・サービスを呼び出すことができます。別の会話型サーバーとの接続を確立することもできますが、この機能はAUDITCでは提供されていません。
bankappでは、12種類のリクエスト/レスポンス・サービスが提供されます。bankappの各サービス名は、サーバーのソース・コード内にあるC言語の関数名と一致します。
次の擬似コードは、bankappの各サービスで使用されるアルゴリズムを示しています。サービスには、BR_ADD、TLR_ADD、OPEN_ACCT、CLOSE_ACCT、WITHDRAWAL、DEPOSIT、INQUIRY、TRANSFER、ABAL、TBAL、ABAL_BID、およびTBAL_BIDがあります。 このサンプル・コードを参考にすると、bankappサーバーのソース・コードを理解しやすくなります。
void BR_ADD (TPSVCINFO *transb)
{
-set pointer to TPSVCINFO data buffer;
-get all values for service request from field buffer;
-insert record into BRANCH;
-tpreturn() with success;
}
void TLR_ADD (TPSVCINFO *transb)
{
-set pointer to TPSVCINFO data buffer;
-get all values for service request from fielded buffer;
-get TELLER_ID by reading branch's LAST_ACCT;
-insert teller record;
-update BRANCH with new LAST_TELLER;
-tpreturn() with success;
}
void OPEN_ACCT(TPSVCINFO *transb)
{
-Extract all values for service request from fielded buffer using Fget()
and Fvall();
-Check that initial deposit is positive amount and tpreturn() with
failure if not;
-Check that branch ID is a legal value and tpreturn() with failure if it
is not;
-Set transaction consistency level to read/write;
-Retrieve BRANCH record to choose new account based on branch's LAST_ACCT
field;
-Insert new account record into ACCOUNT file;
-Update BRANCH record with new value for LAST_ACCT;
-Create deposit request buffer with tpalloc(); initialize it for FML with
Finit();
-Fill deposit buffer with values for DEPOSIT service request;
-Increase priority of coming DEPOSIT request since call is from a service;
-Do tpcall() to DEPOSIT service to add amount of initial balance;
-Prepare return buffer with necessary information;
-Free deposit request buffer with tpfree();
tpreturn() with success;
}
void CLOSE_ACCT(TPSVCINFO *transb)
{
-Extract account ID from fielded buffer using Fvall();
-Check that account ID is a legal value and tpreturn() with failure if it
is not;
-Set transaction consistency level to read/write;
-Retrieve ACCOUNT record to determine amount of final withdrawal;
-Create withdrawal request buffer with tpalloc(); initialize it for FML
with Finit();
-Fill withdrawal buffer with values for WITHDRAWAL service request;
-Increase priority of coming WITHDRAWAL request since call is from
a service;
-Do tpcall() to WITHDRAWAL service to withdraw balance of account;
-Delete ACCOUNT record;
-Prepare return buffer with necessary information;
-Free withdrawal request buffer with tpfree();
tpreturn with success;
}
void WITHDRAWAL(TPSVCINFO *transb)
{
-Extract account id and amount from fielded buffer using Fvall() and Fget();
-Check that account id is a legal value and tpreturn() with failure if not;
-Check that withdraw amount (amt) is positive and tpreturn() with failure
if not;
-Set transaction consistency level to read/write;
-Retrieve ACCOUNT record to get account balance;
-Check that amount of withdrawal does not exceed ACCOUNT balance;
-Retrieve TELLER record to get teller's balance and branch id;
-Check that amount of withdrawal does not exceed TELLER balance;
-Retrieve BRANCH record to get branch balance;
-Check that amount of withdrawal does not exceed BRANCH balance;
-Subtract amt to obtain new account balance;
-Update ACCOUNT record with new account balance;
-Subtract amt to obtain new teller balance;
-Update TELLER record with new teller balance;
-Subtract amt to obtain new branch balance;
-Update BRANCH record with new branch balance;
-Insert new HISTORY record with transaction information;
-Prepare return buffer with necessary information;
tpreturn with success;
}
void DEPOSIT(TPSVCINFO *transb)
{
-Extract account id and amount from fielded buffer using Fvall() and Fget();
-Check that account ID is a legal value and tpreturn() with failure if not;
-Check that deposit amount (amt) is positive and tpreturn() with failure if
not;
-Set transaction consistency level to read/write;
-Retrieve ACCOUNT record to get account balance;
-Retrieve TELLER record to get teller's balance and branch ID;
-Retrieve BRANCH record to get branch balance;
-Add amt to obtain new account balance;
-Update ACCOUNT record with new account balance;
-Add amt to obtain new teller balance;
-Update TELLER record with new teller balance;
-Add amt to obtain new branch balance;
-Update BRANCH record with new branch balance;
-Insert new HISTORY record with transaction information;
-Prepare return buffer with necessary information;
tpreturn() with success;
}
void INQUIRY(TPSVCINFO *transb)
{
-Extract account ID from fielded buffer using Fvall();
-Check that account ID is a legal value and tpreturn() with failure if not;
-Set transaction consistency level to read only;
-Retrieve ACCOUNT record to get account balance;
-Prepare return buffer with necessary information;
tpreturn() with success;
}
void TRANSFER(TPSVCINFO *transb)
{
-Extract account ID's and amount from fielded buffer using Fvall()
and Fget();
-Check that both account IDs are legal values and tpreturn() with
failure if not;
-Check that transfer amount is positive and tpreturn() with failure if
it is not;
-Create withdrawal request buffer with tpalloc(); initialize it for
FML with
Finit();
-Fill withdrawal request buffer with values for WITHDRAWAL service request;
-Increase priority of coming WITHDRAWAL request since call is from
a service;
-Do tpcall() to WITHDRAWAL service;
-Get information from returned request buffer;
-Reinitialize withdrawal request buffer for use as deposit request buffer
with Finit();
-Fill deposit request buffer with values for DEPOSIT service request;
-Increase priority of coming DEPOSIT request;
-Do tpcall() to DEPOSIT service;
-Prepare return buffer with necessary information;
-Free withdrawal/deposit request buffer with tpfree();
tpreturn() with success;
}
void ABAL(TPSVCINFO *transb)
{
-Set transaction consistency level to read only;
-Retrieve sum of all ACCOUNT file BALANCE values for the
database of this server group (A single ESQL
statement is sufficient);
-Place sum into return buffer data structure;
tpreturn( ) with success;
}
void TBAL(TPSVCINFO *transb)
{
-Set transaction consistency level to read only;
-Retrieve sum of all TELLER file BALANCE values for the
database of this server group (A single ESQL
statement is sufficient);
-Place sum into return buffer data structure;
tpreturn( ) with success;
}
void ABAL_BID(TPSVCINFO *transb)
{
-Set transaction consistency level to read only;
-Set branch_ID based on transb buffer;
-Retrieve sum of all ACCOUNT file BALANCE values for records
having BRANCH_ID = branch_ID (A single ESQL
statement is sufficient);
-Place sum into return buffer data structure;
tpreturn( ) with success;
}
void TBAL_BID(TPSVCINFO *transb)
{
-Set transaction consistency level to read only;
-Set branch_ID based on transb buffer;
-Retrieve sum of all TELLER file BALANCE values for records
having BRANCH_ID = branch_ID (A single ESQL
statement is sufficient);
-Place sum into return buffer data structure;
tpreturn( ) with success;
}
bankappのソース・ファイルには、appinit.cとutil.cという2つのC言語サブルーチン・ファイルがあります。
appinit.cには、アプリケーション固有のtpsvrinit()とtpsvrdone()サブルーチンが記述されています。tpsvrinit()とtpsvrdone()は、Oracle Tuxedo ATMIの標準main()に含まれているサブルーチンです。tpsvrinit()は、デフォルトで2つの関数を呼び出します。リソース・マネージャを開くtpopen()と、サーバーが起動したことを示すメッセージを記録するuserlog()です。また、tpsvrdone()も、デフォルトで2つの関数を呼び出します。リソース・マネージャを閉じるtpclose()と、サーバーが停止されることを示すメッセージを記録するuserlog()です。これらのデフォルトのサブルーチンのかわりに、アプリケーション固有のtpsvrinit()とtpsvrdone()サブルーチンを使用できます。そのため、アプリケーション固有の初期化処理と停止の前処理を行うことができます。 util.cにはgetstr()というサブルーチンが記述されています。これはbankappでSQLのエラー・メッセージを処理する場合に使用されます。 bankappのソース・ファイルでは、すべてのサービスがサーバーのソース・コードとして参照されるファイルに組み込まれています。 これらのファイルはbankappサーバーと名前が同じですが、main()関数が含まれていないので実際にはサーバーではありません。 標準main()は、buildserverコマンドの実行時にOracle Tuxedo ATMIによって提供されます。
Oracle Tuxedoシステム・アプリケーションを作成する別の方法として、各サービス・サブルーチンを別のファイルに記述する方法があります。 この方法を使用して、TLRサーバーを作成するとします。 TLR.ecファイルには3つのサービスが定義されています。次の手順に従って、これらのサービスをINQUIRY.ec、WITHDRAW.ec、およびDEPOSIT.ecの3つの.ecファイルに分けます。 以下の手順に従います。
この例で説明するように、1つのソース・ファイルにすべてのサービス関数をコーディングする必要はありません。つまり、ソース・プログラム・ファイルとしてサーバーが存在する必要はまったくありません。様々なソース・ファイルから導出し、buildserverコマンドラインで指定したファイルを介して実行可能なサーバーとして存在することが可能です。これによりサーバーをより自由にビルドできます。
ここでは、bankappの実行に必要なファイルとリソースを作成するための手順を順に示します。
環境変数は、bankvarファイルに定義されています。 このファイルは数多くのコメントが記述された大きな(約185行から構成される)ファイルです。
bankvarファイルの内容を確認します。 TUXDIRパラメータにOracle Tuxedoシステムのディレクトリ構造でのルート・ディレクトリを設定し、エクスポートします。 bankvarの別のコード行で、APPDIRに${TUXDIR}/samples/atmi/bankappが設定されています。これは、bankappソース・ファイルが置かれたディレクトリです。 APPDIRは、Oracle Tuxedoシステムによって、アプリケーション固有のファイルが検索されるディレクトリです。 オリジナルのソース・ファイルを上書きしないように、bankappファイルを別のディレクトリにコピーします。 その場合は、そのディレクトリをAPPDIRに指定します。 TUXDIRの下位ディレクトリである必要はありません。 DIPCKEYに値を設定します。 これは、Oracle Tuxedoシステム・データベースのIPCKEYです。 DIPCKEYの値は、UBBCONFIGファイルで指定されたOracle TuxedoシステムのIPCKEYとは異なる値を指定する必要があります。 | 注意: | bankvarで指定されるほかの変数は、サンプル・アプリケーションで各種の働きをします。独自のアプリケーションを開発する場合は、それらの働きについて認識しておくことが必要です。 bankvarにはすべての変数が定義されているので、後で実際のアプリケーションのテンプレートとして使用できます。 |
bankvarに必要な変更を加えたら、次のようにbankvarを実行します。 . ./bankvar
# Copyright (c) 1997, 1996 BEA Systems, Inc.
# Copyright (c) 1995, 1994 Novell, Inc.
# Copyright (c) 1993, 1992, 1991, 1990 Unix System Laboratories, Inc.
# All rights reserved
#
# This file sets all the environment variables needed by the TUXEDO software
# to run the bankapp
#
# This directory contains all the TUXEDO software
# System administrator must set this variable
#
if [ -z "${TUXDIR}" ] ; then
if [ ! -z "${ROOTDIR}" ] ; then
TUXDIR=$ROOTDIR
export TUXDIR
fi
fi
TUXDIR=${TUXDIR:?}
#
# Reset LANG if necessary
#
if [ ! -d ${TUXDIR}/locale/C -a -d ${TUXDIR}/locale/english_us ] ; then
export LANG
LANG=english_us.ascii
fi
#
# This directory contains all the user written code
#
# Contains the full path name of the directory that the application
# generator should place the files it creates
#
APPDIR=${TUXDIR}/apps/bankapp
#
# This path contains the shared objects that are dynamically linked at
# runtime in certain environments, e.g., SVR4.
#
LD_LIBRARY_PATH=${TUXDIR}/lib:${LD_LIBRARY_PATH}
#
# Set the path to shared objects in HP-UX
#
SHLIB_PATH=${TUXDIR}/lib:${SHLIB_PATH}
#
# Set the path to shared objects in AIX
#
LIBPATH=${TUXDIR}/lib:/usr/lib:${LIBPATH}
#
# Logical block size; Database Administrator must set this variable
#
BLKSIZE=512
#
# Set default name of the database to be used by database utilities
# and database creation scripts
#
DBNAME=bankdb
#
# Indicate whether database is to be opened in share or private mode
#
DBPRIVATE=no
#
# Set Ipc Key for the database; this MUST differ from the UBBCONFIG
# *RESOURCES IPCKEY parameter
#
DIPCKEY=80953
#
# Environment file to be used by tmloadcf
#
ENVFILE=${APPDIR}/ENVFILE
#
# List of field table files to be used by mc, viewc, tmloadcf, etc.
#
FIELDTBLS=Usysflds,bankflds,creditflds,eventflds
#
FIELDTBLS32=Usysfl32,evt_mib,tpadm
#
# List of directories to search to find field table files
#
FLDTBLDIR=${TUXDIR}/udataobj:${APPDIR}
#
FLDTBLDIR32=${TUXDIR}/udataobj:${APPDIR}
#
# Universal Device List for database
#
FSCONFIG=${APPDIR}/bankdl1
#
# Network address, used in MENU script
#
NADDR=
#
# Network device name
#
NDEVICE=
#
# Network listener address, used in MENU script
#
NLSADDR=
#
# Make sure TERM is set
#
TERM=${TERM:?}
#
# Set device for the transaction log; this should match the TLOGDEVICE
# parameter under this site's LMID in the *MACHINES section of the
# UBBCONFIG file
#
TLOGDEVICE=${APPDIR}/TLOG
#
# Device for binary file that gives the BEA Tuxedo system all its information
#
TUXCONFIG=${APPDIR}/tuxconfig
#
# Set the prefix of the file which is to contain the central user log;
# this should match the ULOGPFX parameter under this site's LMID in the
# *MACHINES section of the UBBCONFIG file
#
ULOGPFX=${APPDIR}/ULOG
#
# System name, used by RUNME.sh
#
UNAME=
#
# List of view files to be used by viewc, tmloadcf, etc.
#
VIEWFILES=aud.V
#
VIEWFILES32=mib_views,tmib_views
#
# List of directories to search to find view files
#
VIEWDIR=${TUXDIR}/udataobj:${APPDIR}
#
VIEWDIR32=${TUXDIR}/udataobj:${APPDIR}
#
# Specify the Q device (if events included in demo)
#
QMCONFIG=${APPDIR}/qdevice
#
# Export all variables just set
#
export TUXDIR APPDIR BLKSIZE DBNAME DBPRIVATE DIPCKEY ENVFILE
export LD_LIBRARY_PATH SHLIB_PATH LIBPATH
export FIELDTBLS FLDTBLDIR FSCONFIG MASKPATH OKXACTS TERM
export FIELDTBLS32 FLDTBLDIR32
export TLOGDEVICE TUXCONFIG ULOGPFX
export VIEWDIR VIEWFILES
export VIEWDIR32 VIEWFILES32
export QMCONFIG
#
# Add TUXDIR/bin to PATH if not already there
#
a="`echo $PATH | grep ${TUXDIR}/bin`"
if [ x"$a" = x ]
then
PATH=${TUXDIR}/bin:${PATH}
export PATH
fi
#
# Add APPDIR to PATH if not already there
#
a="`echo $PATH | grep ${APPDIR}`"
if [ x"$a" = x ]
then
PATH=${PATH}:${APPDIR}
export PATH
fi
#
# Check for other machine types bin directories
#
for DIR in /usr/5bin /usr/ccs/bin /opt/SUNWspro/bin
do
if [ -d ${DIR} ] ; then
PATH="${DIR}:${PATH}"
fi
done
| 注意: | Sun Solarisを使用している場合は、シェルとしてcshではなく、/bin/shを使用し、次のように、PATHの先頭に/usr/5binを指定する必要があります。 |
PATH=/usr/5bin:$PATH;export PATH
buildserver(1)コマンドを使用して、Oracle TuxedoシステムのATMI main()関数で実行可能ATMIサーバーを作成します。 このコマンドではオプションを使用して、出力ファイル、アプリケーションで提供される入力ファイル、各種の方法でOracle Tuxedoシステム・アプリケーションを実行するためのライブラリを指定します。
buildserverは、ccコマンドを呼び出します。 環境変数のCCを設定すると別のコンパイル・コマンドを指定でき、CFLAGSを設定するとコンパイル時と編集時にフラグを設定できます。 buildserverコマンドはbankapp.mkで使用され、銀行業務アプリケーションの各サーバーをコンパイルしてビルドします。 以下に、bankappの6種類のサーバーについて説明します。
ACCTサーバーは、OPEN_ACCTおよびCLOSE_ACCT関数のコードが記述されたACCT.ecファイルから生成されます。 このサーバーをビルドするには、 ACCT.ecをコンパイルしてACCT.oファイルを生成し、それをbuildserverコマンドに渡します。この方法では、コンパイル・エラーを特定でき、サーバーをビルドする前に修正することができます。
以下は、buildserverコマンドラインで指定されている各オプションの説明です。
-rオプションは、実行可能サーバーにリンクされるリソース・マネージャのアクセス・ライブラリを指定します。 指定する値は、文字列TUXEDO/SQLで開始します。-sオプションは、サーバーの起動時に公開されるサーバーのサービス名を指定します。サービスを実行する関数名がサービス名と異なる場合、関数名が-sオプションの引数の一部になります。bankappでは、関数名はサービス名と同じなので、サービス名だけを指定します。サービス名は、すべての文字列を大文字で指定します。たとえば、OPEN_ACCTサービスは、OPEN_ACCT()関数で処理されます。ただし、buildserverの-sオプションでは、サーバー内のサービスを処理する関数には任意の名前を付けることができます。詳細は、buildserver(1)のリファレンス・ページを参照してください。システム管理者は、buildserverコマンドでサーバーを作成した際に使用されたサービスのサブセットだけをサーバーの起動時に利用できるように設定することもできます。 -oオプションは、実行可能出力ファイルに名前を指定する場合に使用します。 名前が指定されていない場合は、SERVERという名前が付きます。 -fオプションは、リンク時と編集時に使用されるファイルを指定します。関連情報については、buildserver(1)リファレンス・ページの-lを参照してください。ファイルがリストされる順序は、関数の参照、およびその参照がどのライブラリで解決されるかによって決定されます。ソース・モジュールは、関数の参照が解決されるライブラリの前にリストされます。.cファイルが存在する場合、それが最初にコンパイルされます。上記の例では、appinit.oとutil.oはすでにコンパイルされています。オブジェクト・ファイルは、別個の.oファイル、またはアーカイブ(.a)ファイルにあるファイル・グループです。-fの引数として1つ以上のファイル名を指定する場合は、二重引用符で各ファイル名を囲む必要があります。-fの引数としては、1つのファイルまたは二重引用符で囲まれた1つのファイル・リストしか指定できませんが、-fオプションは1つのコマンドラインで必要に応じて何度でも指定できます。 以下に、ACCTサーバーを作成するために、buildserverコマンドラインに指定されたオプションで行われる操作を簡単にまとめます。
-rオプションは、Oracle TuxedoシステムSQLリソース・マネージャを指定します。-sオプションは、ACCTサーバーを構成するサービスとして、OPEN_ACCTサービスとCLOSE_ACCTサービス(ACCT.ecファイルにある同名の関数で定義されるサービス)を指定します。-oオプションは、実行可能出力ファイルにACCTという名前を指定します。-fオプションは、ACCT.o、appinit.o、およびutil.oファイルがビルドでのリンク時と編集時に使用されることを指定します。 | 注意: | appinit.cファイルには、システムによって提供されるtpsvrinit()およびtpsvrdone()関数が含まれています。 これらのルーチンの使用方法については、tpservice(3c)のリファレンス・ページを参照してください。 |
BALサーバーは、ABAL、TBAL、ABAL_BID、およびTBAL_BID関数のコードが記述されたBAL.ecファイルから生成されます。 ACCT.ecファイルと同様に、BAL.ecをコンパイルしてBAL.oファイルを生成し、それをbuildserverコマンドに渡します。そのため、コンパイル・エラーを特定でき、サーバーをビルドする前に修正することができます。
BTADDサーバーは、BR_ADDおよびTLR_ADD関数のコードが記述されたBTADD.ecファイルから生成されます。 BTADD.ecをコンパイルしてBTADD.oファイルを生成し、それをbuildserverコマンドに渡します。
TLRサーバーは、DEPOSIT、WITHDRAWAL、およびINQUIRY関数のコードが記述されたTLR.ecファイルから生成されます。 TLR.ecをコンパイルしてTLR.oファイルを生成し、それをbuildserverコマンドに渡します。
buildserverコマンドでTLRサーバーをビルドします。buildserver -r TUXEDO/SQL \
-s DEPOSIT -s WITHDRAWAL -s INQUIRY \
-o TLR \
-f TLR.o -f util.o -f -lm
| 注意: | 上記のコマンドラインの円マークは、改行を明示的に示すために表記されているだけです。 コマンドとオプションは1行に入力できます。 |
-rオプションは、Oracle TuxedoシステムSQLリソース・マネージャを指定します。-sオプションは、TLRサーバーを構成するサービスとして、DEPOSIT、WITHDRAWAL、およびINQUIRYを指定します。 これらのサービス名は、そのサービスを定義するTLR.ecファイルの関数名と同じです。-oオプションは、実行可能サーバーにTLRという名前を指定します。-fオプションは、TLR.oとutil.oファイルがリンク時と編集時に使用されることを指定します。 | 注意: | 上記のサンプル・コードでは、-fを使用して、オプション(-lm)をccコマンドに渡しています。このコマンドは、buildserverによって呼び出されます。 -fに-lmの引数を指定すると、コンパイル時にmathライブラリがリンクされます。 |
コンパイル時に使用できるオプションについては、『UNIX System V User's Reference Manual』のcc(1)を参照してください。
XFERサーバーは、TRANSFER関数のコードが記述されたXFER.cファイルから生成されます。 XFER.cをコンパイルしてXFER.oファイルを生成し、それをbuildserverコマンドに渡します。
bankappサーバーをビルドする場合、buildserverコマンドの指定方法を理解していることが大切です。 ただし、実際にビルドする場合、makefileにビルドの定義を記述することがよくあります。bankappでもその方法が採用されています。
bankappには、すべてのスクリプトを実行可能にし、VIEW記述ファイルをバイナリ形式に変換し、アプリケーション・サーバーの作成に必要なすべてのプリコンパイル、コンパイル、およびビルドを行うmakefileが提供されています。 また、最初からやり直す場合にもこのファイルを利用できます。
提供されているbankapp.mkをそのまま使わずにフィールドを編集した方がよい場合があります。また、説明が必要なフィールドもあります。以下にそれらのフィールドについて説明します。
bankapp.mkファイルの40行目前後に、次のコメントとTUXDIRパラメータが記述されています。 #
# Root directory of TUXEDO System. This file must either be edited to set
# this value correctly, or the correct value must be passed via "make -f
# bankapp.mk TUXDIR=/correct/tuxdir", or the build of bankapp will fail.
#
TUXDIR=../..
TUXDIRパラメータを、Oracle Tuxedoシステム・インストールのルート・ディレクトリの絶対パス名に設定します。 APPDIRパラメータに設定された値を確認します。 bankappの場合、APPDIRにはbankappファイルが置かれたディレクトリ(TUXDIRの相対パス)が指定されています。 次に示すbankapp.mkのセクションには、APPDIRの設定についての説明と定義が記述されています。 #
# Directory where the bankapp application source and executables reside.
# This file must either be edited to set this value correctly, or the
# correct value must be passed via "make -f bankapp.mk
# APPDIR=/correct/appdir", or the build of bankapp will fail.
#
APPDIR=$(TUXDIR)/samples/atmi/bankapp
#
READMEファイルに従って、別のディレクトリにファイルをコピーした場合、APPDIRにはファイルのコピー先のディレクトリを指定します。 makefileを実行すると、そのディレクトリにアプリケーションがビルドされます。 デフォルトでは、bankappはデータベース・リソース・マネージャとしてOracle Tuxedo/SQLを使用するように設定されています。 その場合、ご使用のシステムにOracle Tuxedoシステム・データベースがインストールされていることが必要です。 インストールされていない場合は、RMパラメータにTUXDIR/udataobj/RMにリストされているリソース・マネージャの名前を設定します。
#
# Resource Manager
#
RM=TUXEDO/SQL
#
| 注意: | Oracle Tuxedo SQLリソース・マネージャは、デモ用のプログラムです。 |
ここでは、bankappとリソース・マネージャ(通常はデータベース管理システム)間のインタフェース、およびbankappデータベースを作成する方法について説明します。bankappでは、Oracle Tuxedoシステム・データベース、つまりXA準拠のリソース・マネージャのOracle Tuxedo/SQLの機能が使用されます。
| 注意: | Oracle Tuxedo SQLリソース・マネージャは、デモ用のプログラムです。 |
bankappデータベースの作成方法は、アプリケーションを単一プロセッサ(SHMモード)または複数プロセッサのネットワーク(MPモード)のいずれで起動するかによって異なります。
XA準拠の代替リソース・マネージャでbankappを実行するには、各種のファイルを変更する必要があります。 ここでは、次の内容について説明します。
bankappでは、データベースへのすべてのアクセスは埋め込み型SQL文で実行されます。そのため、新しいリソース・マネージャでSQLがサポートされている場合は問題がありません。 appinit.cユーティリティには、tpopen()とtpclose()への呼出しが定義されています。
crbankが代替リソース・マネージャで処理されないことがあります。 crbankは、変数をリセットして、crbankdbを3回実行するだけです。crbankdbを使用する場合は注意します。 次のコード・リストは、crbankdbスクリプトの最初の部分です。 このサンプル・コードの後に、Oracle Tuxedoシステム以外のリソース・マネージャでは機能しないコード部分について説明してあります。#Copyright (c) BEA Systems, Inc.
#All rights reserved
#
# Create device list
#
dbadmin<<!
echo
crdl
# Replace the following line with your device zero entry
${FSCONFIG} 0 2560
!
#
# Create database files, fields, and secondary indices
#
sql<<!
echo
create database ${DBNAME} with (DEVNAME='${FSCONFIG}',
IPCKEY=${DIPCKEY}, LOGBLOCKING=0, MAXDEV=1,
NBLKTBL=200, NBLOCKS=2048, NBUF=70, NFIELDS=80,
NFILES=20, NFLDNAMES=60, NFREEPART=40, NLCKTBL=200,
NLINKS=80, NPREDS=10, NPROCTBL=20, NSKEYS=20,
NSWAP=50, NTABLES=20, NTRANTBL=20, PERM='0666',
STATISTICS='n'
)
create table BRANCH (
BRANCH_ID integer not null,
BALANCE real,
LAST_ACCT integer,
LAST_TELLER integer,
PHONE char(14),
ADDRESS char(60),
primary key(BRANCH_ID)
) with (
FILETYPE='hash', ICF='PI', FIELDED='FML',
BLOCKLEN=${BLKSIZE}, DBLKS=8, OVBLKS=2
)
最初の40行を見れば、変更の必要のあるものと変更しなくてもよいものがわかります。見てわかるように、crbankdbは、dbadminおよびsqlシェル・コマンドに対する入力情報を提供する2つのドキュメントで構成されています。1つ目のhereファイルは、データベースのデバイス・リスト作成のためにOracle Tuxedoシステム・コマンドdbadminに渡されます。
このコマンドは、Oracle Tuxedoリソース・マネージャだけで機能します。表スペースを作成したり、適切な権限を認めるために、ほかのコマンドが必要になる場合があります。
GROUPSセクションで、TMSNAMEおよびOPENINFOパラメータに適切な値(つまり、リソース・マネージャで認識される値)を指定します。
nt\bankvar.cmdを編集し、次の環境変数に適切な値を指定します。TUXDIR : Root directory for the BEA TUXEDO system installationAPPDIR: Application directory in whichbankappfiles are located
ORACLE_HOME : Root directory of the Oracle8 installationORACLE_SID : Oracle System IDBLK_SIZE: Logical block sizeDBNAME: default name of the database to be used by database utilities and database creation scriptsDBPRIVATE: indicates whether database is to be opened in share or private mode (yes or no)FSCONFIG:Universal Device List for databasePATH=%TUXDIR%\bin;%TUXDIR%\include;%TUXDIR%\lib;%ORACLE_HOME%\bin;%PATH%INCLUDE=%ORACLE_HOME%\rdbms80\xa; %ORACLE_HOME%\pro80\c\include;%include%NLSPATH=%TUXDIR%\locale\CPLATFORM=inwnt40LIB=%TUXDIR%\lib; %ORACLE_HOME%\pro80\lib\msvc; %ORACLE_HOME%\rdbms80\xa; %lib%;>bankvar
TUXDIR\udataobj\RMファイルを編集します。$TUXDIR\udataobj\RMファイルに次の行を追加します。Oracle_XA;xaosw;%ORACLE_HOME%\pro80\lib\msvc\sqllib80.lib%ORACLE_HOME%\RDBMS80\XA\xa80.lib
Oracleがネットワーク上にある場合は、次のように編集します。
$TUXDIR\udataobj\RMファイルに次の行を追加します。Oracle_XA;xaosw;f:\orant\pro80\lib\msvc\sqllib80.lib f:\orant\RDBMS80\XA\xa80.lib
RMファイルで、Oracle_XAの以前のエントリを削除します。cd $APPDIR
buildtms -r Oracle_XA -o TMS_ORA
nt\bankapp.makファイルを編集します。*.ecファイルを更新します。 Oracle SQLコマンドを使用します。copy nt\bankapp.mak to %APPDIR%
nmake -f bankapp.mak
nt\ubbshmを編集します。USER_ID=0
GROUP_ID=0
UNAME_SITE1=nodename returned by hostname
TUXDIR=same as specified in bankvar
APPDIR=same as specified in bankvar
GROUPSセクションを変更します。TMSNAME=TMS_ORA
BANKB1 GRPNO=1 OPENINFO="Oracle_XA:Oracle_XA+Acc=P/user1/PaSsWd1+SesTm=0+LogDir=."
[
Oracle_XA +
required fields:
Acc=P/oracle_user_id/oracle_password +
SesTm=Session_time_limit (maximum time a transaction can be inactive) +
optional fields:
LogDir=logdir (where XA library trace file is located) +
MaxCur=maximum_#_of_open cursors +
SqlNet=connect_string (if Oracle exists over the network)
(eg. SqlNet=hqfin@NEWDB indicates the database with sid=NEWDB accessed at host hqfin by TCP/IP)
]
BANKB2 GRPNO=2
OPENINFO="Oracle_XA:Oracle_XA+Acc=P/user2/PaSsWd2+SesTm=0+LogDir=."
BANKB3 GRPNO=3
OPENINFO="Oracle_XA:Oracle_XA+Acc=P/user3/PaSsWd3+SesTm=0+LogDir=."
tmloadcf -y nt/ubbshm
TLOGデバイスを作成します。crtlog -m
tmboot -y
v$XATRANS$ビューがデータベースにあることを確認します。 V$XATRANS$ビューは、XAライブラリのインストール時に作成されます。v$XATRANS$ビューが作成されていない場合は、次のように作成します。bankappデータベースとOracle RMのデータベース・オブジェクトを作成します。notepad crbank-ora8.sqlbankappアプリケーションでこのデータベースを使用できます。sqlスクリプトによってデータベース内に新しい表スペースが作成され、bankappのすべてのデータベース・オブジェクトを格納できます。新しい表スペースを使用するには、Oracleシステム・ユーザー・パスワードとファイルのフルパス名を入力する必要があります。crbank-ora8.sqlを編集します。WHENEVER OSERROR EXIT ;
/*Obtain the password for user "system" */
PROMPT
PROMPT
PROMPT -- Some of the operations require "system" user privileges
PROMPT -- Please specify the Oracle "system" user password
PROMPT
ACCEPT syspw CHAR PROMPT 'system passwd:' HIDE ;
CONNECT system/&syspw ;
SHOW user ;
PROMPT
/* Create a new tablespace in the default DB for use with "bankapp" */
DROP TABLESPACE bank1
INCLUDING CONTENTS
CASCADE CONSTRAINTS;
PROMPT
PROMPT
PROMPT -- Will create a 3MB tablespace for bankapp ;
PROMPT -------- Please specify full pathname below for Datafile ;
PROMPT -------- Ex: %ORACLE_HOME%/dbs/bankapp.dbf
PROMPT
ACCEPT datafile CHAR PROMPT 'Datafile:' ;
CREATE TABLESPACE bank1
DATAFILE '&datafile' SIZE 3M REUSE
DEFAULT STORAGE (INITIAL 10K NEXT 50K
MINEXTENTS 1 MAXEXTENTS 120
PCTINCREASE 5)
ONLINE;
/***************** Create a user called "user1" ***************/
DROP USER user1 CASCADE;
PROMPT Creating user "user1"
CREATE USER user1 IDENTIFIED by PaSsWd1
DEFAULT TABLESPACE bank1
QUOTA UNLIMITED ON bank1 ;
GRANT CREATE SESSION TO user1 ;
GRANT CREATE TABLE TO user1 ;
CONNECT user1/PaSsWd1 ;
SHOW user ;
PROMPT Creating database objects for user "user1" ;
PROMPT Creating table "branch" ;
CREATE TABLE branch (
branch_id NUMBER NOT NULL PRIMARY KEY,
balance NUMBER,
last_acct NUMBER,
last_teller NUMBER,
phoneCHAR(14),
address CHAR(60)
)
STORAGE (INITIAL 5K NEXT 2K
MINEXTENTS 1 MAXEXTENTS 5 PCTINCREASE 5) ;
PROMPT Creating table "account" ;
CREATE TABLE account (
account_id NUMBER NOT NULL PRIMARY KEY,
branch_id NUMBER NOT NULL,
ssn CHAR(12) NOT NULL,
balance NUMBER,
acct_type CHAR,
last_name CHAR(20),
first_name CHAR(20),
mid_init CHAR,
phoneCHAR(14),
address CHAR(60)
)
STORAGE (INITIAL 50K NEXT 25K
MINEXTENTS 1 MAXEXTENTS 50 PCTINCREASE 5) ;
PROMPT Creating table "teller" ;
CREATE TABLE teller (
teller_id NUMBER NOT NULL PRIMARY KEY,
branch_id NUMBER NOT NULL,
balance NUMBER,
last_name CHAR(20),
first_name CHAR(20),
mid_init CHAR
)
STORAGE (INITIAL 5K NEXT 2K
MINEXTENTS 1 MAXEXTENTS 5 PCTINCREASE 5) ;
PROMPT Creating table "history" ;
CREATE TABLE history (
account_id NUMBER NOT NULL,
teller_id NUMBER NOT NULL,
branch_id NUMBER NOT NULL,
amount NUMBER
)
STORAGE (INITIAL 400K NEXT 200K
MINEXTENTS 1 MAXEXTENTS 5 PCTINCREASE 5) ;
SQL*plus> start $APPDIR/ crbank-ora8.sql
nt\populate
driver
bankappクライアントを実行します。run
tmshutdown -y
構成ファイルには、アプリケーションの実行方法が定義されています。bankappには、テキスト形式の構成ファイル(UBBCONFIG(5)を参照)が2つ提供されています。単一のコンピュータ上のアプリケーションを定義するubbshmと、ネットワーク上のアプリケーションを定義するubbmpです。
初期化スクリプトは、サンプル・アプリケーションに提供されています。 また、ご使用の構成およびマシンに合わせて、.shを使用して10個までの完全な構成ファイルを生成できます。
bankappのubbshmおよびubbmp構成ファイルの内容を確認します。 #Copyright (c) 1999 BEA Systems, Inc.
#All rights reserved
*RESOURCES
IPCKEY 80952
001 UID <user id from id(1)>
002 GID <group id from id(1)>
PERM 0660
MAXACCESSERS 40
MAXSERVERS 35
MAXSERVICES 75
MAXCONV 10
MAXGTT 20
MASTER SITE1,SITE2
SCANUNIT 10
SANITYSCAN 12
BBLQUERY 180
BLOCKTIME 30
DBBLWAIT 6
OPTIONS LAN,MIGRATE
MODEL MP
LDBAL Y
##SECURITY ACL
#
*MACHINES
003 <SITE1's uname> LMID=SITE1
004 TUXDIR="<TUXDIR>"
005 APPDIR="<APPDIR>"
ENVFILE="<APPDIR>/ENVFILE"
TLOGDEVICE="<APPDIR>/TLOG"
TLOGNAME=TLOG
TUXCONFIG="<APPDIR>/tuxconfig"
006 TYPE="<machine type>"
ULOGPFX="<APPDIR>/ULOG"
007 <SITE2's uname> LMID=SITE2
TUXDIR="<TUXDIR>"
APPDIR="<APPDIR>"
ENVFILE="<APPDIR>/ENVFILE"
TLOGDEVICE="<APPDIR>/TLOG"
TLOGNAME=TLOG
TUXCONFIG="<APPDIR>/tuxconfig"
TYPE="<machine type>"
ULOGPFX="<APPDIR>/ULOG"
#
*GROUPS
#
# Group for Authentication Servers
#
Group for Application Queue (/Q) Servers
#
##QGRP1 LMID=SITE1 GRP=102
## TMSNAME=TMS_QM TMSCOUNT=2
## OPENINFO=”TUXEDO/QM:<APPDIR>/qdevice:QSP_BANKAPP”
#
# Group for Event Broker Servers
#
##EVBGRP1 LMID=SITE1 GRPNO=104
DEFAULT: TMSNAME=TMS_SQL TMSCOUNT=2
BANKB1 LMID=SITE1 GRPNO=1
008 OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl1:bankdb:readwrite"
BANKB2 LMID=SITE2 GRPNO=2
OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl2:bankdb:readwrite"
*NETWORK
009 SITE1 NADDR="<network address of SITE1>"
010 NLSADDR="<network listener address of SITE1>"
011 SITE2 NADDR="<network address of SITE2>"
012 NLSADDR="<network listener address of SITE2>"
ubbshmまたはubbmpのRESOURCESセクションに次の行を追加します。 SECURITY APP_PW
RESOURCES、MACHINESおよびGROUPSセクションにあります。ubbmpでは、NETWORKセクションにも置換が必要な値があります。表3-3では、ubbmpをNETWORKセクションまで示し、単一マシン用のアプリケーションを作成する際、RESOURCES、MACHINESおよびGROUPSの各セクションに必要となる変更もすべて説明しています。
バイナリ形式の構成ファイルを作成する場合、bankappファイルが置かれたディレクトリに移動し、環境変数を設定することが必要です。 その場合、次の手順に従います。
| 注意: | SHMモードでbankappを実行する場合は、tlistenプロセスを作成したり、別のマシンにトランザクション・ログを作成する必要はありません。 |
構成ファイルを編集したら、それをMASTERマシン上にバイナリ・ファイルとしてロードする必要があります。 バイナリ形式の構成ファイルの名前はTUXCONFIG、そのパス名はTUXCONFIG環境変数に定義されています。 このファイルは、Oracle Tuxedoのシステム管理者の有効なユーザーIDおよびグループIDを持つユーザーが作成します。この2つのIDは、ご使用の構成ファイルのUIDおよびGIDの値と同じであることが必要です。 同じではない場合、bankappの実行時にパーミッションの問題が発生します。
TUXCONFIGは、MASTERマシン上だけにインストールできます。アプリケーションの起動時にtmbootによってほかのマシンに伝播されます。
構成のオプションとしてSECURITYが指定されている場合、tmloadcfの実行時にアプリケーション・パスワードの入力が求められます。 30文字までのパスワードを指定できます。アプリケーションに参加するクライアント・プロセスでは、パスワードを入力する必要があります。
ロードする前にtmloadcfによってテキスト形式の構成ファイル(UBBCONFIG)が解析されます。構文エラーが検出された場合、ファイルのロードは失敗します。
TLOGは、Oracle Tuxedoシステムがグローバル・トランザクションを管理するために使用するトランザクション・ログです。 アプリケーションを起動する前に、アプリケーションのすべてのマシン上のすべてのファイルにTLOGのエントリが作成されることが必要です。また、ログ自体のファイルは、MASTERマシン上に作成されることが必要です。
bankappでは、デバイス・リストとTLOGを作成するcrtlogと呼ばれるスクリプトが提供されています。 デバイス・リストは、bankvarのTLOGDEVICE変数を使用して作成されます。
XA準拠ではないリソース・マネージャを使用している場合、トランザクション・ログは不要です。
tlistenはリスナー・プロセスで、Oracle Tuxedoアプリケーションのマシン間でtmbootなどのプロセスにリモート・サービス接続を提供します。 構成ファイルのNETWORKセクションで定義されたネットワーク上のすべてのマシンにインストールされていることが必要です。
tlistenの起動については、『Oracle Tuxedoシステムのインストール』の「tlistenプロセスの開始」を参照してください。
bankapp用に新たにtlistenプロセスを起動することをお薦めします。その場合、次のコマンドを入力します。tlisten -l nlsaddr
nlsaddrの値は、構成ファイルでこのマシンのNLSADDRパラメータに指定された値と同じにする必要があります。 この値はマシンによって異なるため、tlistenの引数が構成ファイルで指定された値と一致していることが重要です。
| 注意: | この指定に関するエラーは、簡単には検出できません。tmloadcfでは、構成ファイルの値とtlistenコマンドの引数が一致しているかどうかは確認されません。 この2つのアドレスが異なる場合、nlsaddrの値が一致しないマシンで起動に失敗します。また、tlistenプロセスが開始されていないマシンでも起動に失敗します。 |
tlistenで使用されるログ・ファイルは、Oracle Tuxedoシステムのほかのすべてのログ・ファイルとは別のログ・ファイルです。ただし、複数のtlistenプロセスで1つのログ・ファイルを使用できます。 デフォルトのファイル名は、TUXDIR/udataobj/tlogです。
tlistenは、デーモン・プロセスとして実行されます。 tlistenを起動スクリプトに組み込んだり、cronジョブとして実行する方法については、『Tuxedoコマンド・リファレンス』の「tlisten(1)」を参照してください。
bankappでは、tlistenに対して開始または終了のどちらかの操作しかできません。 tlistenを終了するには、次のようにSIGTERMシグナルを送信します。
| 注意: | Windows 2003環境でリスナー・プロセスを開始または停止するには、コマンドラインでtlistenを実行するか、またはコントロール・パネルを使用します。 |
実行中のリモートtlistenがない場合、起動シーケンスが画面に次のように表示されます。
Booting admin processes
exec DBBL -A :
on MASTER -> process id=17160Started.
exec BBL -A :
on MASTER -> process id=17161Started.
exec BBL -A :
on NONMAST2 -> CMDTUX_CAT:814: cannot propagate TUXCONFIG file
tmboot: WARNING: No BBL available on site NONMAST2.
Will not attempt to boot server processes on that site.
exec BBL -A :
on NONMAST1 -> CMDTUX_CAT:814: cannot propagate TUXCONFIG file
tmboot: WARNING: No BBL available on site NONMAST1.
Will not attempt to boot server processes on that site.
2 processes started.
and messages such as these will be in the ULOG:
133757.mach1!DBBL.17160: LIBTUX_CAT:262: std main starting
133800.mach1!BBL.17161: LIBTUX_CAT:262: std main starting
133804.mach1!BRIDGE.17162: LIBTUX_CAT:262: std main starting
133805.mach1!tmboot.17159: LIBTUX_CAT:278: Could not contact NLS on NONMAST2
133805.mach1!tmboot.17159: LIBTUX_CAT:276: No NLS available for remote
machine NONMAST2
133806.mach1!tmboot.17159: LIBTUX_CAT:276: No NLS available for remote
machine NONMAST2
133806.mach1!tmboot.17159: CMDTUX_CAT:850: Error sending TUXCONFIG
propagation request to TAGENT on NONMAST2
133806.mach1!tmboot.17159: WARNING: No BBL available on site NONMAST2.
Will not attempt to boot server processes on that site.
133806.mach1!tmboot.17159: LIBTUX_CAT:278: Could not contact NLS on NONMAST1
133806.mach1!tmboot.17159: LIBTUX_CAT:276: No NLS available for
remote machine NONMAST1
133806.mach1!tmboot.17159: LIBTUX_CAT:276: No NLS available for
remote machine NONMAST1
133806.mach1!tmboot.17159: CMDTUX_CAT:850: Error sending TUXCONFIG
propagation request to TAGENT on NONMAST1
133806.mach1!tmboot.17159: WARNING: No BBL available on site NONMAST1.
Will not attempt to boot server processes on that site.
If tlisten is started with the wrong machine address, the following messages
appear in the tlisten log.
Mon Aug 26 10:51:56 1991; 14240; Oracle TUXEDO System Listener Process Started
Mon Aug 26 10:51:56 1991; 14240; Could not establish listening endpoint
Mon Aug 26 10:51:56 1991; 14240; Terminating listener process, SIGTERM
ここでは、bankappを起動し、各種のクライアント・プログラムとトランザクションを行ってテストし、終了する手順について順に説明します。 各作業をクリックすると、その作業を行う手順が表示されます。
bankappを起動する前に、アプリケーションをサポートするのに十分なIPCリソースがマシンにあることを確認します。 IPCリソースに関するレポートを出力するには、tmbootコマンドに-cオプションを指定します。| 注意: | IPCリソースが不足していると起動が失敗する場合があるので、構成に対して適切な値が指定されていることを確認してください。 |
Ipc sizing (minimum /T values only)
Fixed Minimums Per Processor
SHMMIN: 1
SHMALL: 1
SEMMAP: SEMMNI
Variable Minimums Per Processor
SEMUME, A SHMMAX
SEMMNU, * *
Node SEMMNS SEMMSL SEMMSL SEMMNI MSGMNI MSGMAP SHMSEG
------ ------ ------ ------ ------ ------ ------ ------
sfpup 60 1 60 A + 1 10 20 76K
sfsup 63 5 63 A + 1 11 22 76K
where 1 <= A <= 8.
MSGMNI値に追加します。 MSGMAPはMSGMNIの2倍にします。
このレポートは、構成内のすべてのサーバーが起動するまで出力されます。 起動したサーバーの合計数が出力された時点で終了します。
必要であれば、構成の一部のサーバーだけを起動することもできます。 たとえば、管理サーバーだけを起動するには、-Aオプションを指定します。 オプションが指定されていない場合は、アプリケーション全体が起動します。
tmbootでは、起動したサーバー数がレポートされるほかに、ULOGにメッセージが送信されます。
populate.shは、データベースにレコードを追加するシェル・スクリプトです。このスクリプトを使用して、bankappを実行して、その機能をテストします。populateは、gendataと呼ばれるプログラムからシステム・サーバーudにレコードを渡す1行のスクリプトです。gendataプログラムは、10支店、30窓口、200口座のレコードを作成します。作成されたファイル内のレコードは、pop.outに記録されるので、サービス・リクエストの作成時にデータベースの値を使用することができます。
スクリプトを実行するには、「populate」と入力します。
| 注意: | populateスクリプトで出力されたpop.outでは、口座番号や支店番号などのフィールドを指定して取得できるので、自分のサービス・リクエストに対する出力を生成できます。 |
bankappに環境変数を設定する必要があります。 その場合、次のコマンドを入力します。. ./bankvar
auditクライアント・プログラムを実行します。auditクライアント・プログラムを実行するには、次のコマンドを入力します。 audit {-a | -t} [branch_id] 口座残高を取得する場合は-a、窓口残高を取得する場合は-tを指定します。 branch_idが指定されている場合、指定された支店だけがレポートされます。指定されていない場合、すべての支店データがレポートされます。 口座番号、支店番号などauditに入力する値には、populateプログラムの出力であるpop.outにリストされている値を使用できます。
auditconを実行します。 auditプログラムの会話型バージョンを起動するには、次のコマンドを入力します。 auditcon
to request a TELLER or ACCOUNT balance for a branch,
type the letter t or a, followed by the branch id,
followed by <return>
for ALL TELLER or ACCOUNT balances, type t or a <return>
q <return> quits the program
リクエストを入力して「Enter」を押すと、指定された情報と次のメッセージが表示されます。
another balance request ??
qを入力するまで繰り返し表示されます。 -nオプションを使用します。driver -n1000
このコマンドは、プログラムが1000回ループして実行されることを指定しています。
driverは、システム上での処理をシミュレートするための一連のトランザクションを生成するスクリプトです。 このスクリプトは、bankappの一部として含まれているので、tmadminコマンドを実行して実際的な統計を取得できます。
bankappを終了するには、次のように、引数を指定せずにtmshutdown(1)コマンドをMASTERマシンで入力します。
$ tmshutdown
Shutdown all server processes? (y/n): y
Shutting down all server processes in /usr/me/BANKAPP/TUXCONFIG
Shutting down server processes ...
Server Id = 1 Group Id = BANKB1 Machine = Site1: shutdown succeeded.
このコマンド(またはtmadminの停止コマンド)を実行すると、次のタスクが行われます。
|