最简单的类似HelloWorld的tuxedo程序

　　一个TUXEDO 应用可以分成3部分：(1)发布交易请求的客户端(2)运行响应请求交易的服务(3)描述应用机器和服务信息的配置文件。以下是tuxedo的一个简单例子，大家很容易能从这个例子中明白中间件的编程思想，程序的各个函数都加上了注释以便于理解。

　　程序功能：客户端请求交易"TOUPPER"，数据是"hello world"。交易"TOUPPER"将字符串转成大写，将结果成功返回客户端。

　　程序代码：

　　(1)客户端程序：

　　#include

　　#include "atmi.h"

　　/*包含TUXEDO系统的头文件"atmi.h",以便引用TUXEDO的函数和变量定义。*/

　　main()

　　{

　　char *buf;

　　long len;

　　/*客户端调用tpinit()连接应用*/

　　if (tpinit((TPINIT * )NULL) == -1)

　　{

　　exit(1);

　　}

　　/*用tpalloc()分配一个STRING类型数据缓冲*/

　　if ((buf=tpalloc("STRING",NULL,80))==NULL)

　　{

　　tpterm();

　　exit(2);

　　}

　　/*将"hello world"拷贝进缓冲*/

　　strcpy(buf, "hello world");

　　/*用tpcall()包含数据缓冲，向交易"TOUPPER"发一个同步请求*/

　　if ( tpcall("TOUPPER",buf,0,&buf,&len,0)== -1)

　　{

　　fprintf(stderr,"service requst fail\n");

　　tpfree(buf);

　　tpterm();

　　exit(3);

　　}

　　/*打印出改变的数据缓冲*/

　　printf("return string is :%s\n",buf);

　　tpfree(buf);

　　/*调用tpterm()切断与应用的连接*/

　　tpterm();

　　exit(0);

　　}

　　(2)交易程序（服务端程序）：

　　#include

　　#include

　　#include "atmi.h"

　　/*包含TUXEDO系统头文件"atmi.h"*/

　　/* 象所有的TUXEDO交易函数一样，TOUPPER不用直接返回任何值，所以返回类型为void */

　　/*从客户端收到的数据放在TPSVCINFO结构中，是唯一的入参*/

　　void TOUPPER (TPSVCINFO *rqst)

　　{

　　int i;

　　for ( i=0;ilen-1;i++)

　　rqst->data[i] = toupper(rqst->data[i]);

　　/*用tpreturn()将数据缓冲返回客户端*/

　　tpreturn(TPSUCCESS,0,rqst->data,0L,0);

　　}

　　(3)配置文件

　　有关应用的信息，如可用交易，交易位置，应用范围等，有必要集中管理于单一资源。事实上，这些信息被集中于文件UBBCONFIG。

　　如下所示（每个字段的含义参见BEA公司的文档）：

　　#file : ubbconfig

　　*RESOURCES

　　IPCKEY 5000

　　MASTER SITE1

　　MODEL SHM

　　*MACHINES

　　gumby LMID=SITE1

　　TUXDIR ="/usr/tuxedo"

　　APPDIR ="/usr/apps/simpapp"

　　TUXCONFIG ="/usr/apps/simpapp/simpapp.tux"

　　*GROUPS

　　GROUP1 LMID=SITE1 GRPNO=1

　　*SERVERS

　　simpserv SRVGRP=GROUP1 SRVID=1

　　*SERVICES

　　TOUPPER

　　(4)建立应用

　　建立一个TUXEDO应用，必须进行以下步骤：

　　设置环境变量：TUXEDO用户目录（TUXDIR）、二进制配置文件名（TUXCONFIG）、TUXEDO可执行文件路径、公共库路径（LD_LIBRARY_PATH）

　　用buildclient命令从源程序编译出客户端可执行文件：buildclient -f client.c -o client -v

　　用buildserver命令从源程序编译出服务端可执行文件，-s参数列出提供的交易：buildserver -f simpserv.c -o simpserv -s TOUPPER -v

　　用tmloadcf命令从文本配置文件ubbconfig生成二进制配置文件tuxconfig：tmloadcf -y ubbconfig

　　好了。一个简单的tuxedo程序就算完成了。开发TUXEDO C/S系统的必要步骤无非就是：配置环境变量、编码并编译客户端和服务端的程序、由文本的ubbconfig生成二进制TUXCONFIG、启动系统和服务、测试应用和关闭系统。