准备bankapp的文件和资源
⑴．设置环境变量
将samples\atmi\bankapp\nt下的bankvar文件改名为bankvar.bat,复制到父目录，然后对其进行编辑：
@echo off
rem %Tuxedo%为Tuxedo安装目录，APPDIR是bankapp所在的目录
set APPDIR=%TUXDIR%\samples\atmi\bankapp
rem消息所在目录
set NLSPATH=%TUXDIR%\locale\C
rem逻辑块大小，数据库管理员必须设置
set BLKSIZE=512
rem 被缺省使用的数据库名字
set DBNAME=bankdb
rem 指示数据库为共享模式还是私有模式
set DBPRIVATE=no
rem 指示数据库使用的IPC值，必须与ubbconfig中的IPCKEY不同
set DIPCKEY=80953
rem 由tmloadcf使用的环境文件
set ENVFILE=%APPDIR%\ENVFILE
rem 由mc, viewc, tmloadcf使用的字段表文件
set FIELDTBLS=Usysflds,bankflds,creditflds
rem 查找字段表文件的目录
set FLDTBLDIR=%TUXDIR%\udataobj;%APPDIR%
rem 数据库使用的通用设备列表
set FSCONFIG=%APPDIR%\bankdl1
rem MENU中使用的网络地址
set NADDR=
rem 网络设备名
set NDEVICE=
rem MENU脚本中使用的网络监听器地址
set NLSADDR=
rem 事务日志设备，必须和ubbconfig中MACHINES节
rem LMID站点的TLOGDEVICE参数相同
set TLOGDEVICE=%APPDIR%\TLOG
rem 为/T提供全部信息的二进制配置文件
set TUXCONFIG=%APPDIR%\tuxconfig
rem 用户日志文件，必须和ubbconfig中的MACHINES节
rem LMID站点的ULOGPFX参数相同
set ULOGPFX=%APPDIR%\ULOG
rem 由RUNME.sh使用的系统名
set UNAME=
rem 由viewc, tmloadcf使用的view文件列表
set VIEWFILES=aud.vv
set VIEWFILES32=mib_views,tmib_views
rem 查找view文件的目录
set VIEWDIR=%TUXDIR%\udataobj;%APPDIR%
set VIEWDIR32=%TUXDIR%\udataobj;%APPDIR%
rem 指定Q设备
set QMCONFIG=%APPDIR%\qdevice
set PATH=%TUXDIR%\bin;%PATH%
rem 指出Visual C++安装的目录
set MSDEV=G:\Program Files\Microsoft Visual Studio\VC98
set PATH=%PATH%;%MSDEV%\bin
set INCLUDE=%INCLUDE%;%MSDEV%\include;%MSDEV%\mfc\include
set LIB=%LIB%;%MSDEV%\lib;%MSDEV%\mfc\lib
⑵．Build
bankapp的应用程序
bankapp的5个服务器：ACCT、BAL、BTADD、TLR、XFER。用一个命令就可以完成编译任务：
G:\Tuxedo\samples\atmi\bankapp\nmake
bankapp.nt
若要手工完成编译，首先要将EC文件编译成C文件：
G:\Tuxedo\samples\atmi\bankapp\ESQLC
ACCT.EC
生成FML缓冲区头文件：
G:\Tuxedo\samples\atmi\bankapp\mkfldhdr
bankflds eventflds
生成目标文件：
G:\Tuxedo\samples\atmi\bankapp\CL
/c ACCT.c appinit.c util.c
生成ACCT.exe文件：
buildserver -r TUXEDO/SQL -s OPEN_ACCT -s
CLOSE_ACCT
-o ACCT.exe
-f ACCT.obj -f
appinit.obj -f util.obj
-r指示哪一个资源管理器的访问库将被编译到acct.exe文件中，本例为TUXEDO/SQL
⑶．编辑bankapp的make文件
在NT平台下，bankapp提供的make文件为bankapp.nt，使用前需要检查一下环境变量TUXDIR、APPDIR的设置。另外一个要注意的地方就是资源管理器参数RM，缺省使用TUXEDO/SQL，因为Tuxedo为bankapp提供数据库服务。如果使用了其它数据库产品，需要把RM参数设置成%TUXDIR%\udataobj\RM文件列表中的某一个值。
⑷．创建bankapp的数据库
bankapp使用了TUXEDO/SQL作为资源管理器，它是一个XA-compliant的资源管理器，XA是事务管理器和资源管理器之间的接口。在单处理机SHM模式和多处理机MP模式下创建数据库的方式是不同的，在SHM模式下，创建步骤如下：
设置环境变量： G:\Tuxedo\samples\atmi\bankapp\bankvar
执行批处理文件：G:\Tuxedo\samples\atmi\bankapp\crbank
crbank.cmd调用crbankdb三次，每次调用前改变一些环境变量，执行完成后，同一台机器上有三个数据文件，这样，就可以在单机上模拟网络环境。在MP模式下创建数据库的步骤如下：
设置环境变量：G:\Tuxedo\samples\atmi\bankapp\bankvar
在一台机器上创建数据库：G:\Tuxedo\samples\atmi\bankapp\crbankdb
在其它机器上，修改bankvar.cmd文件中的数据库通用设备列表FSCONFIG，修改ubbmp配置文件中的相应部分，再进行创建操作。
⑸．准备一个XA-compliant资源管理器
若不使用TUXEDO/SQL作为资源管理器，而使用其它的XA-compliant资源管理器，需要作很多修改：修改bankvar.cmd、修改bankapp服务、修改bankapp.nt文件、修改crbank和crbankdb文件、修改配置文件。
修改bankvar.cmd文件。下面是TUXEDO/SQL资源管理器的配置，已经不能用了，你需要根据实际的数据库系统对这些值进行修改：
BLKSIZE=512
DBNAME=bankdb
DBPRIVATE=no
DIPCKEY=80953
FSCONFIG=${APPDIR}/bankdl1
修改bankapp的服务。bankapp中所有数据库访问都是通过ESQL来完成的，如果你的新资源管理器支持SQL，这就没什么问题。appinit.c中包含了打开和关闭数据库的tpopen()和tpclose()。
修改bankapp.nt。将RM参数修改为新的资源管理器，确保RM文件中有如下入口：
$TUXDIR/udataobj/RM
如果必要，改变SQL编译器和它的选项，源文件的扩展名不一定是EC，你需要指预编译的命令及参数，以ORACLE为例，使用PROC将PC文件预编译成C文件。
修改crbank和crbankdb。注意crbankdb创建的SQL语句在新资源管理器中是否能接受。修改配置文件。在GROUPS节中，为TMSNAME和OPENM指定一个适当的值参数值，这个值要让资源管理器能够识别。
⑹．如何将bankapp和Oralce8进行集成
Oracle8是XA兼容的资源管理器，要实现和bankapp的集成，按如下步骤进行：
①．编辑bankvar.cmd文件，修改如下环境变量的值：
ORACLE_HOME：Oracle8的安装目录
ORACLE_SID：Oracle的系统ID
BLK_SIZE：逻辑块的尺寸
DBNAME：缺省数据库
DBPRIVATE：指示数据库是以共享模式还是私有模式打开(yes/no)
FSCONFIG：数据库使用的通用设置列表
PATH=%PATH%;%ORACLE_HOME%\bin
INCLUDE=%ORACLE_HOME%\rdbms80\xa;
%ORACLE_HOME%\pro80\c\include
PLATFORM=inwnt40
LIB=%TUXDIR%\lib %ORACLE_HOME%\pro80\lib\msvc;
%ORACLE_HOME%\rdbms80\xa;
②．运行bankvar.cmd
③．编辑%TUXDIR%\udataobj\RM文件，追加如下行：
Oracle_XA;xaosw;%ORACLE_HOME%\pro80\lib\msvc\sqllib80.lib
%ORACLE_HOME%\RDBMS80\XA\xa80.lib
如果Oracle服务器在网络的另一端，把那台机器映射到驱动器，如F；
把如下行追加到%TUXDIR%\udataobj\RM文件中：
Oracle_XA;xaosw;f:\orant\pro80\lib\msvc\sqllib80.lib
f:\orant\RDBMS80\XA\xa80.lib
删除RM文件中以前的Oracle_XA入口
④．为Oracle8创建事务管理服务器
cd %APPDIR%
buildtms -r Oracle_XA -o TMS_ORA
⑤．编辑nt\bankapp.mak文件
RM=Oracle_XA
ORACLE_LIB=$(ORACLE_HOME)\PRO80\LIB
RMNAME=Oracle_XA
SQLPUBLIC=$(ORACLE_HOME)\PRO80\C\INCLUDE
ORACLE_DIR=$(ORACLE_HOME)\bin
在.ec.c节中，编辑从EC到C的创建规则，不再使用ESQLC了，而使用PROC：
set
TUXDIR=$(TUXDIR) & $(ORACLE_DIR)\proc80
mode=ansi
release_cursor=yes
include=$(SQLPUBLIC)
include=$(INCDIR)
$(SQL_PLATFORM_INC)
-c iname=$*.ec
在.c.obj节中，编辑规则，作出下设置：
$(CC)
-c $(CFLAGS) $(SQLPUBLIC) $(INCLUDE) $*.c
⑥．使用Oracle的SQL命令更新EC文件
⑦．将nt\bankapp.mak复制到%APPDIR%下，然后Make一下：
copy nt\bankapp.mak %APPDIR%
nmake –f bankapp.mak
⑧．编辑nt\ubbshm文件：
USER_ID=0
GROUP_ID=0
UNAME_SITE1=执行hostname返回值，用大写形式
TUXDIR=与bankvar.cmd中的相同
APPDIR=与bankvar.cmd中的相同
⑨．在配置文件的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
在Master机上创建TLOG设备和设备列表：crtlog
–m
启动数据库服务器，启动Tuxedo系统：tmboot
–y，确保数据库中存在V%XATRANS%视图，如果不存在，以系统用户登录Oracle，然后执行%ORACLE_HOME%\RDBMS80\ADMIN\XAVIEW.SQL，授予使用XA库的Oracle用户Select权限。
在Oracle8中创建bankapp使用的数据库对象。Oracle8安装以后，会创建一个示例数据库，bankapp可以使用这个数据库。编辑crbank-ora8.sql文件，内容如下：
WHENEVER OSERROR EXIT ;
/* 获取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
/* 在缺省数据库中为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;
/* 创建一个名叫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中执行上面这段SQL语句：
SQL*plus>
start $APPDIR/ crbank-ora8.sql
填充数据库：
nt\populate
在Oracle数据库中生成事务
driver
运行bankapp的客户程序：
run
关闭Tuxedo应用程序：
tmshutdown -y
⑹．如何编辑配置文件
配置文件定义了应用程序如何运行。bankapp有两个配置文件：ubbshm和ubbmp。ubbshm定义了在单机环境下如何运行bankapp，ubbmp定义了在网络环境下如何运行bankapp。
①．打开并编辑ubbmp，将<…>替换成际值。对于ubbmp，NETWORK节必须替换
*RESOURCES
IPCKEY 80952
UID
<user id from id(1)>
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
<SITE1’s
uname> LMID=SITE1
TUXDIR="<TUXDIR>"
APPDIR="<APPDIR>"
ENVFILE="<APPDIR>/ENVFILE"
TLOGDEVICE="<APPDIR>/TLOG"
TLOGNAME=TLOG
TUXCONFIG="<APPDIR>/tuxconfig"
TYPE="<machine
type>"
ULOGPFX="<APPDIR>/ULOG"
<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
OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl1:bankdb:readwrite"
BANKB2 LMID=SITE2 GRPNO=2
OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl2:bankdb:readwrite"
*NETWORK
SITE1
NADDR="<network address of SITE1>"
NLSADDR="<network
listener address of SITE1>"
SITE2
NADDR="<network address of SITE2>"
NLSADDR="<network
listener address of SITE2>"
②．UID：公告栏中IPC结构所有者有效的用户ID，在ubbmp中，所有机器上的UID必须相同，为了避免引起混乱，输入Tuxedo系统的所有者ID。GID与UID类似。SITE1’s name：机器名，在UNIX下为uname –n的结果。machine
type：一个字符串，在网络环境下，用于标识一类计算机，两台计算机通信时，Tuxedo系统检查它们的机器类型，如果不同，在它们之间传递的数据就需要进行编码和解码操作，以便两台机器都能够识别它们。SITE2 name：第二台机器的机器名。OPENINFO：一个只有Tuxedo资源管理器才能识别的格式化字符串，若使用其它的资源管理器如Oracle，必须对它进行修改，以满足要求。Network
address of SITE1：SITE1上BRIDGE进程网络监听器完整地址， BRIDGE是一个维护着和其它参与计算的节点之间虚电路的系统进程，以便这些节点之间可以进行消息传递。Network listener address of SITE1：SITE1上tlisten进程监听器地址。Network
address of SITE2和Network listener address of SITE2同上。
③．要使应用程序具有口令特征，在ubbshm或ubbmp中的RESOURCE节中加入：
SECURITY APP_PW
⑺．创建二进制配置文件和事务日志文件
如果你在SHM模式下运行，你就没有必要在其它机器上创建tlisten进程和事务日志。
在%APPDIR%下运行bankar.cmd设置环境变量；
①．加载配置文件
tmloadcf
–y ubbmp；TUXCONFIG只需要在Master机上安装，当用tmboot启动应用程序时，它就会自动地传给其它机器。如果指定了SECURITY，tmloadcf就会提示你输入应用程序的口令，可以长达30个字符。当客户进程试图加入应用程序时，就要求提供应用程序口令、用户名、用户口令。
②．创建事务日志文件TLOG
TLOG是Tuxedo系统管理全局事务使用的事务日志文件，在应用程序启动之前，在运行应用程序的每一台机器上必须创建一个TLOG入口，TLOG文件本身在Master机上创建。bankapp提供了一个叫crtlog的脚本，它创建了一个设备列表和一个TLOG文件，设备列表使用bankvar.cmd中的TLOGDEVICE变量来创建。要创建TLOG文件和设备列表，在Master机上运行:
crtlog
–m
在生产环境中，设备列表名和数据库中用到的设备列表名必须相同。
在所有其它机器上，不要指定-m开关，当系统启动时，每一台非Master机上的BBL会创建日志。如果你使用了一个non-XA的资源管理器，就没有必要创建事务日志。
⑻．在每台机器上创建远程服务连接
tlisten是一个监听进程，它为tmboot之类的进程提供了远程服务连接。它必须在网络中的每一台机器上安装，并与配置文件中NETWORK段的描述一致。推荐用如下命令启动另一个tlisten进程：
tlisten –l nlsaddr
nlsaddr值必须和配置文件中NLSADDR参数值一致，tlisten使用的logfile和Tuxedo系统其它log文件分开了。一个日志文件可以被多个tlisten进程使用，缺省文件名是：%TUXDIR%\udataobj\tlog。
7．运行bankapp
⑴．如何准备启动应用程序
启动bankapp之前，检查你的机器是否还有足够的IPC资源，方法是：
tmloadcf
–c ubbshm
⑵．如何启动bankapp
bankvar
tmboot
–y
你可以只boot配置文件中的一部分服务，如指定-A选项可以只启动管理进程。
⑶．如何填充数据库
使用populate脚本创建填充数据库，gendata创建了10个支行，30个出纳员，200个账号，pop.out保存了创建过程。
⑷．如何测试bankapp的服务
audit
{-t|-a} [branch_id]
auditcon
使用driver程序(UNIX平台下使用，NT平台下使用gt.cmd)，缺省情况下，它生成300个事务，你可以通过-n指定事务数：
driver –n1000
⑸．如何关闭bankapp