TUXEDO函数说明

【TUXEDO函数说明】 TUXEDO是一款企业级的事务处理监控系统，它提供了一套API（应用程序编程接口）来支持分布式应用的开发。本文主要解释了TUXEDO中的一些关键函数，涉及缓冲区管理、FML操作、连接控制以及请求服务器等方面。 1. **与缓冲区使用有关的ATMI函数** - **tpalloc**: 这个函数用于动态分配缓冲区。参数包括`type`(缓冲区类型)、`subtype`(子类型，通常对于非VIEW类型设为NULL)和`size`(所需缓冲区大小)。成功时返回缓冲区的指针，失败则返回NULL。 - **tprealloc**: 用于调整已分配缓冲区的大小。参数包括`ptr`(原缓冲区指针)和`size`(新缓冲区大小)。成功时返回新分配的缓冲区指针，失败返回NULL。 - **tpfree**: 释放由tpalloc或tprealloc分配的缓冲区。参数`bufptr`是待释放缓冲区的指针。使用tpfree释放的内存不能再用free释放。 - **tptypes**: 返回缓冲区的类型和子类型信息。参数包括`ptr`(缓冲区指针)、`type`和`subtype`。成功返回0，失败则将错误号存入tperrno。 2. **常用的FML(FML32)操作函数** FML32是一种用于数据交换的数据结构，以下是一些基本操作： - **Falloc**: 分配FML缓冲区。参数`FLDOCC`指定字段数量，`FLDLEN`指定缓冲区长度。成功返回指向FML缓冲区的指针，失败返回NULL。 - **Finit**: 初始化FML缓冲区。参数`fbfr`是缓冲区指针，`buflen`是缓冲区长度。失败返回-1，错误号存入Ferror。 - **Fadd**: 在FML缓冲区中添加一个字段值。参数包括`fbfr`(缓冲区指针)，`fieldid`(字段ID)，`value`(值，需转换为char *)和`len`(字段长度)。 - **Fchg**: 更改FML缓冲区中字段的值。参数与Fadd类似，但包含`occ`，用于指定字段出现的次数。 - **Fget**: 从FML缓冲区获取指定字段的值。参数包括`fbfr`，`fieldid`，`occ`，`value`（用于接收值）和`maxlen`（最大长度）。 3. **连接的建立与断开有关的ATMI函数** - **tpchkauth**: 验证连接的权限。这个函数用于检查客户端的认证信息。 - **tpinit**: 初始化TUXEDO环境。这是每个TUXEDO应用启动时必须调用的函数。 - **tpterm**: 终止TUXEDO环境。在应用结束时调用，释放资源。 4. **与请求TUXEDO SERVER 有关的ATMI函数** - **tpcall**: 同步调用远程服务。参数包括服务名、请求和响应的FML缓冲区等。 - **tpacall**: 异步调用远程服务。允许在等待响应时执行其他任务。 - **tpgetrply**: 获取异步调用的回复。当tpacall完成时，使用此函数获取结果。 - **tpcancel**: 取消一个异步调用。 - **tpgprio**和**tpsprio**: 设置或获取线程的优先级，用于控制任务调度。 5. **与请求错误处理有关的ATMI函数** - **tpstrerror**: 将错误代码转换为可读的错误消息字符串。 - **tperrordetail**和**tpstrerrordetail**: 提供错误的详细信息。 这些函数共同构成了TUXEDO的核心功能，使得开发者可以构建高效、可靠的分布式应用程序。理解并熟练运用这些函数，对于构建基于TUXEDO的应用至关重要。