tuxedo命令和配置的詳細(xì)解釋及應(yīng)用實例

tuxed。命令和配置的詳細(xì)解釋及應(yīng)用實例域的組成BDMCONFIG：二進(jìn)制配置文件DMADM:域管理服務(wù)器，管理多個GWADMGWADM:運(yùn)行時網(wǎng)關(guān)管理服務(wù)器，從DMADM服務(wù)器上獲取域信息GWTDOMAIN:是一個網(wǎng)關(guān)進(jìn)程，在域之間轉(zhuǎn)發(fā)消息tmshutdown/tmboot-s服務(wù)名按服務(wù)名停/啟單個服務(wù)tmshutdown/tmboot-S （大寫的S）停/啟所有服務(wù)tmshutdown/tmboot-i進(jìn)程號按進(jìn)程號停/啟單個服務(wù)tmshutdown/tmboot-g組名字按組停/啟服務(wù)tmshutdown/tmboot-y-w1按用戶停/啟服務(wù)tmloadcf-n文件名只做語法檢查不編譯tmloadcf-y文件名編譯二進(jìn)制文件tmloadcf-c文件名測試IPC資源最小需求tmadmin-v版本tmadmin>bbp查BB的參數(shù)bbsBB統(tǒng)計信息pclt連接客戶端信息psrserver信息pscservi。。信息pt當(dāng)前事物信息pq隊列信息echopsr|tmadmin|grep-vIDLEechopsr|tmadmin|sort+4echopsc|tmadmin|sort+6echopq|tmadmin|sort+4echopclt|tmadmin|grep-vWSH|grep-vtmadmin以下是tmadmin命令的printserver(簡寫為psr)的簡單輸出。列號描述服務(wù)的可執(zhí)行文件名服務(wù)連接的隊列名組名服務(wù)的數(shù)字id服務(wù)已經(jīng)處理的請求數(shù)服務(wù)處理的全部請求的參數(shù)和服務(wù)正在處理的交易，若為IDLE則服務(wù)當(dāng)前是空閑ccsmis:/home2/ccsmis>tmadmintmadmin-Copyright(c)1996BEASystems,Inc.Portions*Copyright1986-1997RSADataSecurity,Inc.AllRightsReserved.DistributedunderlicensebyBEASystems,Inc.Tuxedoisaregisteredtrademark.>printserverProgNameQueueNameGrpNameIDRqDoneLoadDoneCurrentService rz_Ecsb 00004.04000 APGP24000 0-0(IDLE )BBL70020simple0 150(IDLE)IFMTMSAPGP2TMSAPGP230001 150(IDLE)交易信息來自GAI的信息本處略去。以下是tmadmin命令的printservice（簡寫為psc）的簡單輸出。列號描述交易名交易函數(shù)名服務(wù)可執(zhí)行文件名服務(wù)所在組名服務(wù)的數(shù)字id提供交易的機(jī)器的LMID交易已經(jīng)執(zhí)行的次數(shù)交易當(dāng)前狀態(tài)ServiceNameRoutineNameProgNameGrpNameIDMachine#DoneStatus416701rz_Ecsbrz_EcsbAPGP24000simple0AVAIL416601rz_Ecsbrz_EcsbAPGP24000simple0AVAIL416501rz_Ecsbrz_EcsbAPGP24000simple0AVAIL隊列信息以下是tmadmin命令的printqueue（簡寫為pq）［qaddress］的簡單輸出。如果不指定address，所有隊列信息將被輸出。列號描述隊列連接的服務(wù)的可執(zhí)行文件名字符隊列名，是RQADDR參數(shù)或一個隨機(jī)值連接的服務(wù)數(shù)當(dāng)前隊列的所有請求的參數(shù)和實際請求數(shù)平均隊列長度隊列所在機(jī)器的LMID>pq00004.05062ProgNameQueueName#ServeWkQueued#QueuedAve.LenMachineCCS_GEDAIPC_5000004.05062 1 0 0 0.0simple客戶端信息來自GAI的信息本處略去。以下是tmadmin命令的printclient(簡寫為pclt)的輸出，來自TUXEDO系統(tǒng)的日志信息。主要有以下信息：客戶端id,用戶名和當(dāng)前狀態(tài)登錄的LMID和進(jìn)程號(PID)服務(wù)組和上一訪問過的服務(wù)組交易(啟動/提交/中斷)和會話的統(tǒng)計數(shù)字中繼隊列id，通知方法和提交控制列號描述已經(jīng)登錄的客戶端機(jī)器的LMID用戶名，由tpinit()提供的客戶端名，由tpinit()提供的客戶端連接后經(jīng)過的時間客戶端狀態(tài)IDLE-—表示客戶端目前沒有任何交易在工作IDLET-—表示客戶端啟動了一個交易BUSY——表示客戶端在工作中BUSYT-—表示客戶端正在交易控制下工作啟動/提交/中斷的交易數(shù)>pcltLMID UserNameClientNameTimeStatusBgn/Cmmt/Abrtsimple ccsmis WSH 17:42:47IDLE 0/0/0simple ccsmis tmadmin 0:44:28IDLE 0/0/0######UBBCONFIG文件的例子：################ident"@(#)apps/simpapp/ubbsimple$Revision:1.3$"#SkeletonUBBCONFIGfilefortheTUXEDOSimpleApplication.^Replacethe<bracketed>itemswiththeappropriatevalues.*RESOURCES #資源IPCKEY123456 #TUXEDO使用它標(biāo)識公告板及其他的IPC資源。它不能與該服務(wù)器上其他的IPC資源的ID號沖突范圍：32,769-262,142DOMAINIDsimpapp#DOMAIN的ID值，該TUXEDO應(yīng)用系統(tǒng)的唯一標(biāo)識MASTERsimple#指定DOMAIN中的管理#MASTERunicom1,unicom2指定DOMAIN中的管理主機(jī)為unicom1,運(yùn)行過程中unicom1若出現(xiàn)問題，管理主機(jī)切換至unicom2UID,GID,PERM:這三個參數(shù)控制對系統(tǒng)IPC資源的存取權(quán)限UID:可對該TUXEDO應(yīng)用系統(tǒng)進(jìn)行管理的TUXEDO系統(tǒng)管理員的用戶ID,在UNIX下就是UNIX系統(tǒng)的用戶ID,默認(rèn)為執(zhí)行TMLOADCF的戶的ID。在NT下該設(shè)置沒有用，要設(shè)為0。GID:在UNIX下為UID中所指定的用戶所在的組ID,在NT下該設(shè)置沒有用,要設(shè)為0PERM:指定對TUXEDO系統(tǒng)IPC資源的存取權(quán)限。默認(rèn)值為0666,即任何人都可以對該IPC資源進(jìn)行存取。MAXACCESSERS,MAXSERVERS,MAXSERVICES:這三個參數(shù)控制該TUXEDO應(yīng)用系統(tǒng)對IPC資源的使用情況MAXACCESSERS100#這里該值表示整個系統(tǒng)中每個機(jī)器上可以訪問TUXEDO的Client和Server的總數(shù)，在本系統(tǒng)的一個節(jié)點(diǎn)（一臺服務(wù)器）上，同時可以有多少個進(jìn)程可以訪問，該TUXEDO系統(tǒng)的公告板，默認(rèn)值為50,它包括本地客戶端進(jìn)程,SERVER進(jìn)程，但不包括管理進(jìn)程如:BBL,DBBL等MAXSERVERS5#最大的server數(shù)，在本系統(tǒng)中，總共可以有多少個SERVER存在，包括進(jìn)行管理的SERVER，如:BBL,TMS等。默認(rèn)值為50。MAXSERVICES10#最大的service數(shù)，在本系統(tǒng)中，總共可以有多少個SEVICE存在，默認(rèn)值為100。TUXEDO應(yīng)用系統(tǒng)的部署方式：一個TUXEDO應(yīng)用系統(tǒng)可能部署在一臺服務(wù)器上或多臺服務(wù)器上，也可能是部署在共用一塊全局共享內(nèi)存的幾臺服務(wù)器上，可在MODEL,OPTIONAS中配置該TUXEDO應(yīng)用系統(tǒng)的部署模式。MODELSHM#cluster方式為MP:多臺服務(wù)器但沒有共用一個全局共享內(nèi)存SHM:單機(jī)或多臺服務(wù)器但共用一個全局共享內(nèi)存TUXEDO的管理進(jìn)程BBL定時對它所在的服務(wù)器上的TUXEDO系統(tǒng)進(jìn)行檢查，檢查超時的事務(wù)，超時的客戶端連接等。SCANUNIT:指定檢查的最小時間單位，它單位為秒，必須是5的倍數(shù)。默認(rèn)值為10,即10秒。SANTIYSCAN:每隔多少個SCANUNIT檢查一次，SANITYSCAN*SCANUNIT不能大于300秒。默認(rèn)值為12,即120秒BLOCKTIME:指定一個消息可以阻塞多長時間，如果過了SANITYSCAN*SCANUNIT秒該消息還沒有發(fā)送出去，將超時出錯。SANITYSCAN*SCANUNIT不能大于32767秒。默認(rèn)值為6,即60秒。同步調(diào)用的超時說明對同步調(diào)用TPCALL,指從TPCALL()開始調(diào)用，到SERVER端的返回結(jié)果到到該客戶端并寫到輸入緩沖區(qū)這一段時間。包括：客戶端開始調(diào)用TPCALL()把數(shù)據(jù)通過網(wǎng)絡(luò)發(fā)送到SERVER端SERVER端的處理時間SERVER端把處理結(jié)果通過網(wǎng)絡(luò)返回給客戶端客戶端TPCALL()調(diào)用返回異步調(diào)用和會話方式的超時說明對異步調(diào)用和會話方式，當(dāng)一個進(jìn)程調(diào)用TPACALL(),TPCONNECT(),TPSEND()時,超時時間只包括如果接收隊列滿時，這些調(diào)用的等待時間，如在TPACALL()中，所調(diào)用的SERVICE的接收隊列如果滿了，那么TPACALL()可阻塞在那里，直到該隊列不滿，可以接收該TPACALL()發(fā)送的請求。從TPACALL()開始阻塞到TPACALL()返回這段時間為它的超時時間。對TPGETRPLY(),TPRECV()的超時時間是指如果要接收的隊列為空時，它們應(yīng)該阻塞在那里等待有消息到來的時間。如:超時時間為60秒，一點(diǎn)整調(diào)用TPGETRPLY()從接收的隊列取消息，這時接收隊列為空,如果到了一點(diǎn)零一分該接受隊列還為空，那么TPGETRPLY（）將超時出錯LDBALN#要不要進(jìn)行負(fù)載均衡,Y:要,N:不要,默認(rèn)值為不要MAXCONV:在一臺服務(wù)器上最多可以有多少個會話同時存在。范圍:0-32768,默認(rèn)值為10NOTIFY:設(shè)置消息的通知方式，有以下3種:默認(rèn)為DIPINIGNORE:該TUXEDO系統(tǒng)中的CLIENT不接收任何消息SIGNAL:用SIGUSR1,SIGUSR2信號通知CLIENT有消息到來，如果在非UNIX平臺上設(shè)置采用該方式，那么會被自動轉(zhuǎn)化為DIPIN方式。DIPIN:當(dāng)CLIENT調(diào)用ATMI函數(shù)時，順便檢查看是否有消息，如果有就發(fā)送給該CLIENT默認(rèn)值為DIPIN*MACHINES#網(wǎng)絡(luò)主機(jī)名用hostname獲得。該TUXEDO應(yīng)用系統(tǒng)所包含的每臺服務(wù)器都要在該節(jié)中進(jìn)行配置CCBFJF85LMID=simple #LMID:在TUXEDO，要為該應(yīng)用系統(tǒng)中的每臺服務(wù)器指定一個邏輯服務(wù)器名。APPDIR="/home/tuxedo/samples/atmi/simpapp"#APPDIR要求放置SERVER的可執(zhí)行文件,TUXEDO應(yīng)用系統(tǒng)所在的目錄TUXCONFIG="/home/tuxedo/etc/tuxconfig" #TUXCONFIG為全路徑的二進(jìn)制配置文件,要求和環(huán)境變量TUXCONFIG相同，配置文件TUXCONFIG所在的路徑TUXDIR="/home/tuxedo" #TUXDIR為tuxedo安裝目錄，要求和環(huán)境變量TUXDIR相同。注意：TUXCONFIG，TUXDIR，APPDIR的值要與它們在環(huán)境變量中的設(shè)置的值一樣MAXWSCLIENTS=50#MAXWSCLIENTS表示可連接client的最大個數(shù)。ENVFILE:該服務(wù)器上與TUXEDO有關(guān)的環(huán)境變量（如FIELDTBLS等）可以放到一個文件中，在ENVFILE中指定該文件名。TYPE:指定該服務(wù)器的類型，當(dāng)兩臺服務(wù)器的TYPE不一樣時，在它們之間傳送數(shù)據(jù)時要進(jìn)行編碼/解碼工作ULOGPFX:指定ULOG文件所在的目錄及前綴。默認(rèn)目錄為$APPDIR,前綴為ULOG。UID,GID,PERM,MAXACCESSERS,MAXCONV這些在RESOURCES中的配置,在MACHINES中可以被重新配置,并且這些新的配置值會覆蓋在RESOURCES中的配置值。*GROUPSGROUP1 #GROUP1為組名LMID=simple #LMID表示該組運(yùn)行的主機(jī)GRPNO=1 #GRPNO為組號OPENINFO=NONE#OPENINFO為該組打開數(shù)據(jù)庫的初始串在TUXEDO中，要對SERVER進(jìn)行分組，配置GROUP主要有三個目的，因為GROUP與數(shù)據(jù)庫之間是一對一的關(guān)系，在一TUXEDO應(yīng)用系統(tǒng)中，如果有多個數(shù)據(jù)庫,就要配置多個GROUP,在該GROUP中配置TUXEDO與數(shù)據(jù)庫的連接參數(shù)等。數(shù)據(jù)依賴路由是以GROUP為單位的。進(jìn)行系統(tǒng)遷移時也時以GROUP為單位的一個GROUP有一個名字，還有一個GROUPID,GROUP的名字和GROUPID在一個TUXEDO系統(tǒng)中必須唯一。每個GROUP要指定該GROUP所在的服務(wù)器，及它的ID號，如果該GROUP中的SERVER要與數(shù)據(jù)庫或其他的資源管理器相連，那么要在OPENINFO中設(shè)置連接的參數(shù)。*SERVERS SERVER節(jié)，列出所有服務(wù)程序DEFAULT:本處列出的參數(shù)為其下列出的服務(wù)的缺省值，但可以被單列條目替代相應(yīng)值RESTART 如果設(shè)成Y,則服務(wù)可以重啟動MAXGEN 在GRACE定義時間之內(nèi)，服務(wù)可以重啟動MAXGEN次GRACE 周期，單位是秒RCMD 每次服務(wù)重啟動，本處定義的腳本或命令被執(zhí)行ENVFILE 列有環(huán)境變量的文件，在交易啟動前設(shè)入環(huán)境TLR 一個服務(wù)名，用buildserver建立，應(yīng)在APPDIR或$四乂。旅幾3SRVGRP 服務(wù)屬于一個在*GROUPS節(jié)中定義的服務(wù)組；如果需要移植服務(wù)，也可以定義在多個組中。SRVID 服務(wù)組中代表服務(wù)的唯一值MIN 最少在啟動時啟動的服務(wù)數(shù)MAX 運(yùn)行時，最多可以起的實例數(shù)CLOPT 跟隨服務(wù)啟動的其他參數(shù)-A 服務(wù)內(nèi)建交易全發(fā)布(默認(rèn)值)-r 指定服務(wù)記錄時間戳，用于以后計算交易處理時間-e 定義標(biāo)準(zhǔn)錯誤重定向文件-o 定義標(biāo)準(zhǔn)輸出重定向文件-- TUXEDO參數(shù)和服務(wù)特定參數(shù)的分隔符… 傳給tpsvrinit()的參數(shù)DEFAULT:CLOPT="-A"#WSL用于和client端進(jìn)行連接。-n表示出接入點(diǎn)為IP:PORT方式，#-m-M表示最小和最大啟動多少個WSH和前端通訊，#-x則表示一個WSH和幾個client端連接。#-T10表示如果client端和server連接后10分鐘內(nèi)沒有交易請求則關(guān)閉連接。WSLSRVGRP=GROUPWSLSRVID=1CLOPT=〃-A-t——n //10.229.15.120:8888-d/dev/tcp-p10000-P10950-m40-M80-x30-c0〃simpservSRVGRP=GROUP1SRVID=2CLOPT=〃-A-o./out.log-r-e./err.log”與遠(yuǎn)程客戶端有關(guān)的配置：在MACHINES中要配置MAXWSCLIENTS，即最多可以有多少個遠(yuǎn)程客戶端同時連接到該服務(wù)器上，在上面的例子中為5個在SERVERS中要配置SERVER：WSLWSLSRVGRP=〃GROUP1〃SRVID=1116CLOPT=〃-A——n//192.168.120.113:8888-m2-M5-x6〃說明：-n//192.168.120.113:8888:遠(yuǎn)程客戶端通過該端口與服務(wù)器建立連接-m2:最少啟動多少個WSH進(jìn)程-M5：:最多啟動多少個WSH進(jìn)程，默認(rèn)值為MAXWSCLIENTS/m-x6：每個WSH進(jìn)程可同時處理多少個遠(yuǎn)程客戶端程客戶端所在的服務(wù)器上要配置WSNADDR環(huán)境變量，它的值為-n參數(shù)的值，如在上面的配置中為：SETWSNADDR=//192.168.120.113:8888*SERVICES:在SERVICES中可針對每個SERVIC