资源描述：
《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.3tpgetrply
2、4.4tpcancel4.5tpgprio4.6tpsprio.85与请求错误处理有关的ATMI5.1tpstrerror5.2tperrordetail5.3tpstrerrordetail1与缓冲区使用有关的ATMI1.1tpallocchar*tpalloc(char*type,char*subtype,longsize)描述:分配缓冲区参数:type:缓冲区的类型 subtype:缓冲区的子类型,只有VIEW有子类型,其他的缓冲区该参数要设为NULL long:缓冲区的大小返回
3、值:成功返回一个指向所分配空间首地址的CHAR*形指针,失败返回NULL。1.2tpreallocchar*tprealloc(char*ptr,longsize)描述:重新分配缓冲区参数:ptr:指向原缓冲区首地址的指针 size:新缓冲区的大小返回值:成功返回一个指向新分配空间首地址的CHAR*形指针,失败返回NULL。1.3tpfreevoidtpfree(char*bufptr)描述:释放由TPALLOC()或TPREALLOC()分配的缓冲区参数:bufptr:指向要释放的缓冲区首地址
4、的指针返回值:无注意:用TPALLOC(),TPREALLOC()分配的内存只能有TPFREE()释放掉,不能用FREE()1.4tptypeslongtptypes(char*ptr,char*type,char*subtype)描述:返回有ptr所指向的缓冲区的类型及子类型参数:ptr:指向要进行类型识别的缓冲区首地址的指针 type：类型名 subtype：子类型名（只对VIEW类型有效）返回值:0成功，-1失败,错误号保存在全局变量tperrno中。2常用的FML(FML32)
5、操作函数2.1FallocFBFR*Falloc(FLDOCCF,FLDLENV)描述：分配一块FML缓冲区参数： FLDOCC:该FML缓冲区的字段个数, FLDLEN:该FML缓冲区的长度返回值：成功返回一个指向该FML缓冲区首地址的指针,失败返回NULL，错误号保存在全局变量Ferror中注意: 该FML缓冲区不能用于TPCALL(),TPACALL(),TPRETURN()等中,在这些函数中用到的FML缓冲区只能用TPALLOC()分配。2.2FinitintFin
6、it(FBFR*fbfr,FLDLENbuflen)描述：初始化该FML缓冲区参数： fbfr:一个指向该FML缓冲区首地址的指针 buflen:该FML缓冲区的长度返回值：失败为-1,错误号保存在全局变量Ferror中2.3FaddintFadd(FBFR*fbfr,FLDIDfieldid,char*value,FLDLENlen)描述：往FML缓冲区fbfr中ID为fieldid的字段增加一个值value参数： fbfr: 指向该FML缓冲区首地址的指针 fiel
7、did:要增加的字段的ID value: 要增加的值,如果时其他类型的要转化为char* len: 该字段的长度,如果不时CARRARY类型的,可设为0返回值：失败为-1,错误号保存在全局变量Ferror中2.4FchgintFchg(FBFR*fbfr,FLDIDfieldid,intocc,char*value,FLDLENlen)描述： 改变fbfr中ID为fieldid字段的值。参数： fbfr: 指向该FML缓冲区首地址的指针 fieldid:要增加的字段的IDoc
8、c:下标 value: 该字段的新值,如果时其他类型的要转化为char* len: 该字段的长度,如果不时CARRARY类型的,可设为0返回值：失败为-1，错误号保存在全局变量Ferror中2.5FgetintFget(FBFR*fbfr,FLDIDfieldid,intocc,char*value,FLDLEN*maxlen)描述： 从fbfr缓冲区中取ID为fieldid字段的值到value中。参数： f
