TUXEDO函数的说明 .doc

1与缓冲区使用有关的ATMI 2 1.1tpalloc. 2 1.2tprealloc. 2 1.3tpfree. 2 1.4tptypes. 2 2常用的FML(FML32)操作函数... 3 2.1Falloc. 3 2.2Finit 3 2.3Fadd. 3 2.4Fchg. 3 2.5Fget 4 2.5Fprint 4 2.6Ferror 4 3连接的建立与断开有关的ATMI 5 3.1tpchkauth. 5 3.2tpinit 5 3.3tpterm.. 6 4与请求TUXEDO SERVER 有关的ATMI 6 4.1tpcall 6 4.2tpacall 7 4.3tpgetrply. 7 4.4tpcancel 7 4.5tpgprio. 8 4.6tpsprio. 8 5与请求错误处理有关的ATMI 8 5.1tpstrerror 8 5.2tperrordetail 9 5.3tpstrerrordetail 9 ? ? ? 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：类型名 subtype：子类型名（只对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: 该字段的长