TUXEDO手冊.doc

TUXEDO函数说明 ATMI(应用程序事务监控接口) 1与缓冲区使用有关的ATMI 1.1tpalloc char * tpalloc(char *type, char *subtype, long size)描述:分配缓冲区参数:type:缓冲区的类型 subtype:缓冲区的子类型,只有VIEW有子类型,其他的缓冲区该参数要设为NULL long:缓冲区的大小返回值: 成功返回一个指向所分配空间首地址的CHAR *形指针,失败返回NULL。 1.2tprealloc char * tprealloc(char *ptr, long size)描述:重新分配缓冲区参数:ptr:指向原缓冲区首地址的指针 size:新缓冲区的大小返回值: 成功返回一个指向新分配空间首地址的CHAR *形指针,失败返回NULL。 1.3tpfree void tpfree(char *bufptr)描述:释放由TPALLOC()或TPREALLOC()分配的缓冲区参数:bufptr:指向要释放的缓冲区首地址的指针返回值:无注意: 用TPALLOC(),TPREALLOC()分配的内存只能有TPFREE()释放掉,不能用FREE() 1.4tptypes long tptypes(char *ptr, char *type, char *subtype)描述:返回有ptr所指向的缓冲区的类型及子类型参数: ptr:指向要进行类型识别的缓冲区首地址的指针 type：类型名 ubtype：子类型名（只对VIEW类型有效）返回值:0成功，-1失败, 错误号保存在全局变量tperrno中。 2常用的FML(FML32)操作函数 2.1Falloc FBFR* Falloc (FLDOCC F, FLDLEN V)描述： 分配一块FML缓冲区参数： FLDOCC: 该FML缓冲区的字段个数, FLDLEN: 该FML缓冲区的长度返回值：成功返回一个指向该FML缓冲区首地址的指针,失败返回NULL，错误号保存在全局变量Ferror中。注意: 该FML缓冲区不能用于TPCALL(),TPACALL(),TPRETURN()等中,在这些函数中用到的FML缓冲区只能用TPALLOC()分配。 2.2Finit int Finit(FBFR *fbfr, FLDLEN buflen)描述： 初始化该FML缓冲区参数： fbfr: 一个指向该FML缓冲区首地址的指针 buflen: 该FML缓冲区的长度返回值：失败为-1, 错误号保存在全局变量Ferror中 2.3Fadd int 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.4Fchg int Fchg(FBFR *fbfr, FLDID fieldid,int occ, char *value, FLDLEN len)描述： 改变fbfr中ID为fieldid字段的值。参数： fbfr: 指向该FML缓冲区首地址的指针 fieldid: 要增加的字段的ID value: 该字段的新值,如果时其他类型的要转化为char * len: 该字段的长度,如果不时CARRARY类型的,可设为0返回值：失败为-1，错误号保存在全局变量Ferror中 2.5Fget int Fget(FBFR *fbfr, FLDID fieldid,int occ, char *value, FLDLEN *maxlen)描述： 从fbfr缓冲区中取ID为fieldid字段的值到value中。参数： fbfr: 指向该FML缓冲区首地址的指针 fieldid: 字段的ID value: 取出的值保存到该指针指向的地址中 maxlen: 可以COPY到缓冲区value中的字符串的长度,返回值为真正COPY到该缓冲区的字符串的长度返回值：失败为-1, 错误号保存