Tuxedo常用函数说明ATMI.docVIP

TUXEDO函数说明ATMI(应用程序事务监控接口) 1与缓冲区使用有关的ATMI 1.1 tpalloc1.2 tprealloc1.3 tpfree1.4 tptypes 2常用的FML(FML32)操作函数2.1 Falloc2.2 Finit 2.3 Fadd2.4 Fchg2.5 Fget 2.5 Fprint 2.6 Ferror 3连接的建立与断开有关的ATMI 3.1 tpchkauth3.2 tpinit 3.3 tpterm 4与请求TUXEDO SERVER 有关的ATMI 4.1 tpcall 4.2 tpacall 4.3 tpgetrply4.4 tpcancel 4.5 tpgprio4.6 tpsprio. 8 5与请求错误处理有关的ATMI 5.1 tpstrerror 5.2 tperrordetail 5.3 tpstrerrordetail 1与缓冲区使用有关的ATMI 1. 1tpallocchar * tpalloc(char *type, char *subtype, long size)描述:分配缓冲区参数:type:缓冲区的类型?????? subtype:缓冲区的子类型,只有VIEW有子类型,其他的缓冲区该参数要设为NULL?????? long:缓冲区的大小返回值: 成功返回一个指向所分配空间首地址的CHAR *形指针,失败返回NULL。 1.2 tpreallocchar * tprealloc(char *ptr, long size) 描述:重新分配缓冲区参数:ptr:指向原缓冲区首地址的指针?????? size:新缓冲区的大小返回值: 成功返回一个指向新分配空间首地址的CHAR *形指针,失败返回NULL。 1.3 tpfreevoid tpfree(char *bufptr)描述:释放由TPALLOC()或TPREALLOC()分配的缓冲区参数:bufptr:指向要释放的缓冲区首地址的指针返回值:无注意: 用TPALLOC(),TPREALLOC()分配的内存只能有TPFREE()释放掉,不能用FREE() 1.4 tptypeslong tptypes(char *ptr, char *type, char *subtype)描述:返回有ptr所指向的缓冲区的类型及子类型参数: ptr:指向要进行类型识别的缓冲区首地址的指针??????type：类型名??????ubtype：子类型名（只对VIEW类型有效）返回值:0成功，-1失败, 错误号保存在全局变量tperrno中。 2常用的FML(FML32)操作函数 2.1 FallocFBFR* Falloc (FLDOCC F, FLDLEN V)描述： 分配一块FML缓冲区参数： ???????? FLDOCC: 该FML缓冲区的字段个数, ????????? FLDLEN: 该FML缓冲区的长度返回值：成功返回一个指向该FML缓冲区首地址的指针,失败返回NULL，错误号保存在全局变量Ferror中注意:?? 该FML缓冲区不能用于TPCALL(),TPACALL(),TPRETURN()等中,在这些函数中用到的FML缓冲区只能用TPALLOC()分配。 2.2Finitint Finit(FBFR *fbfr, FLDLEN buflen)描述： 初始化该FML缓冲区参数：??????? fbfr: 一个指向该FML缓冲区首地址的指针??????? buflen: 该FML缓冲区的长度返回值：失败为-1, 错误号保存在全局变量Ferror中 2.3 Faddint Fadd(FBFR *fbfr, FLDID fieldid, char *value, FLDLEN len)描述： 往FML缓冲区fbfr中ID为fieldid的字段增加一个值value参数：??? fbfr:??? 指向该FML缓冲区首地址的指针??? fieldid: 要增加的字段的ID??? value:?? 要增加的值,如果时其他类型的要转化为char *??? len:???? 该字段的长度,如果不时CARRARY类型的,可设为0返回值： 失败为-1, 错误号保存在全局变量Ferror中 2.4 Fchgint Fchg(FBFR *fbfr, FLDID fieldid,int occ, char *value, FLDLEN len)描述：?? 改变fbfr中ID为fieldid字段的值。参数：??? fbfr:??? 指向该FML缓冲区首地址的指针??? fieldid: 要增加的