资源描述:
《tuxedo常用函数说明atmi》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库。
1、TUXEDO函数说明ATMI(应用程序事务监控接口)1与缓冲区使用有关的ATMI1.1tpalloc1.2tprealloc1.3tpfree1.4tptypes2常用的FML(FML32)操作函数2.1Falloc2.2Finit2.3Fadd2.4Fchg2.5Fget2.5Fprint2.6Ferror3连接的建立与断开有关的ATMI3.1tpchkauth3.2tpinit3.3tpterm4与请求TUXEDOSERVER有关的ATMI4.1tpcall4.2tpacall4.3tpgetrply4.4tpcancel4.5tpgprio4.6t
2、psprio.85与请求错误处理有关的ATMI5.1tpstrerror5.2tperrordetail5.3tpstrerrordetail1与缓冲区使用有关的ATMI1.1tpallocchar*tpalloc(char*type,char*subtype,longsize)描述:分配缓冲区参数:type:缓冲区的类型 subtype:缓冲区的子类型,只有VIEW有子类型,其他的缓冲区该参数要设为NULL long:缓冲区的大小返回值:成功返回一个指向所分配空间首地址的CHAR*形指针,失败返回NULL。1.2tpreallocc
3、har*tprealloc(char*ptr,longsize)描述:重新分配缓冲区参数:ptr:指向原缓冲区首地址的指针 size:新缓冲区的大小返回值:成功返回一个指向新分配空间首地址的CHAR*形指针,失败返回NULL。1.3tpfreevoidtpfree(char*bufptr)描述:释放由TPALLOC()或TPREALLOC()分配的缓冲区参数:bufptr:指向要释放的缓冲区首地址的指针返回值:无注意:用TPALLOC(),TPREALLOC()分配的内存只能有TPFREE()释放掉,不能用FREE()1.4tptypeslon
4、gtptypes(char*ptr,char*type,char*subtype)描述:返回有ptr所指向的缓冲区的类型及子类型参数:ptr:指向要进行类型识别的缓冲区首地址的指针 type:类型名 subtype:子类型名(只对VIEW类型有效)返回值:0成功,-1失败,错误号保存在全局变量tperrno中。2常用的FML(FML32)操作函数2.1FallocFBFR*Falloc(FLDOCCF,FLDLENV)描述:分配一块FML缓冲区参数: FLDOCC:该FML缓冲区的字段个数, FLDLEN
5、:该FML缓冲区的长度返回值:成功返回一个指向该FML缓冲区首地址的指针,失败返回NULL,错误号保存在全局变量Ferror中注意: 该FML缓冲区不能用于TPCALL(),TPACALL(),TPRETURN()等中,在这些函数中用到的FML缓冲区只能用TPALLOC()分配。2.2FinitintFinit(FBFR*fbfr,FLDLENbuflen)描述:初始化该FML缓冲区参数: fbfr:一个指向该FML缓冲区首地址的指针 buflen:该FML缓冲区的长度返回值:失败为-1,错误号保存在全局变量Ferror中2.3
6、FaddintFadd(FBFR*fbfr,FLDIDfieldid,char*value,FLDLENlen)描述:往FML缓冲区fbfr中ID为fieldid的字段增加一个值value参数: fbfr: 指向该FML缓冲区首地址的指针 fieldid:要增加的字段的ID value: 要增加的值,如果时其他类型的要转化为char* len: 该字段的长度,如果不时CARRARY类型的,可设为0返回值:失败为-1,错误号保存在全局变量Ferror中2.4FchgintFchg(FBFR*fbfr,FLDIDfieldid,i
7、ntocc,char*value,FLDLENlen)描述: 改变fbfr中ID为fieldid字段的值。参数: fbfr: 指向该FML缓冲区首地址的指针 fieldid:要增加的字段的IDocc:下标 value: 该字段的新值,如果时其他类型的要转化为char* len: 该字段的长度,如果不时CARRARY类型的,可设为0返回值:失败为-1,错误号保存在全局变量Ferror中2.5FgetintFget(FBFR*fbfr,FLDIDfieldid,intocc,char*value,FLDLEN*maxlen)描述:
8、 从fbfr缓冲区中取ID为fieldid字段的值到value中。参数: f