常用tuxedo函数说明.docVIP

部分类型解释： FBFR：域缓存指示器 FLDOCC：域发生事件的序号 FLDLEN：域长度 FLDID：域的类型 FMLTYPE：支持标准的C语言的数据类型：short，long，float，double，char 增加了：string（一组连续的字符串，以NULL结尾） carray（字符数组） pointer（缓存指示器） （一）ATMI函数：Application-Transaction Monitor Interface tpreturn() 表示服务程序结束 1.发送回答给客户端 2.断开服务器开始时建立的所有连接 tpreturn(int rval, long rcode, char *data, long len, long flags) 实例： tpreturn(TPFAIL,-1L,(char *)FBFRrqst,0L,0);程序执行失败，断开所有连接。 tpreturn(TPSUCCESS,0L,(char *)FBFRrqst,0L,0)；程序执行成功，断开所有连接。 1。rval：TPFAIL和TPSUCCESS作为参数有各自的一套内部操作。在实际的程序开发中，程序成功的完成，参数置为TPFAIL； 程序失败则参数置为TPSUCCESS； 2。rcode：程序执行成功置为“0L”，执行失败置为“-1L”。 3。data：回复信息所用的参数。 4。len：指示发送数据缓冲的数量，在BOSS系统中一般置为0L或者忽略。 5。flags：为以后保留的参数必须设为0。 tpbegin()发起事务。失败返回-1，指出错误情况 #include atmi.h int tpbegin(unsigned long timeout, long flags) 实例： tpbegin(TRANSTIME, 0)；发起时间控制的事件。0为预留参数必须置0 tpcommit()事务提交。失败返回-1。 实例： tpcommit(0) tpabort()事务回滚。失败返回-1。 实例： tpabort(0) userlog()打印ULOG信息 #include userlog.h extern char *proc_name; int userlog (format [ ,arg] . . .) char *format; 实例： (void)userlog((char *)T--tpopen failed, Unix error %d\n,Uunixerr) 无返回类型，按字符型打印T--tpopen failed, Unix error ‘Uunixerr’错误内容。 tpalloc()申请缓存空间，失败返回-1 #include atmi.h char * tpalloc(char *type, char *subtype, long size) 1。type：申请缓存空间的类型。 2。subtype：特殊缓存空间的类型，在BOSS系统中一般置为NULL。 3。size：申请缓存空间的大小。 实例： FBFRansw=(FBFR*)tpalloc((char*)FMLTYPE,NULL,Fneeded((FLDOCC)NF,(FLDLEN)NV)); 申请名为FBFRansw的缓存空间，类型为FMLTYPE，无特殊缓存类型，大小为Fneed((FLDOCC)NF，(FLDLEN)NV) tpfree()释放缓存 tpfree(char *ptr) 1。ptr：释放的缓存名 实例： tpfree((char *)FBFRansw); 释放名为FBFRansw的缓存。 tpgetlev()判断是否有事务正在进行，有：返回1，没有：返回0。 #include atmi.h int tpgetlev() 实例： tpgetlev() == 1 tpcall()调用服务端程序，失败返回-1 int tpcall(char *svc, char *idata, long ilen, char **odata, long *olen, long flags) 1。svc：调用的服务名 2。idata：请求数据缓冲器 3。ilen：发送数据缓冲器的数目 4。odata：回复信息写入的缓冲器指针 5。olen：回复信息的长度 6。flags：预留参数必须置0 实例：