tuxedo服务器端ATMI..doc

Tuxedo服务器端ATMI 说明： 本文档描述TUXEDO服务器端ATMI接口调用函数，注意一个service函数能作为client端使用所有客户端ATMI。 Server端ATMI: void tpservice(TPSVCIBFO *svcinfo) 功 能： 当前错误代号。 输入参数： 输出参数： 返 回： char *tpstrerror(int tperrno) 功 能： 获取错误信息。 输入参数： tperrno 错误代号。 输出参数： 返 回： 错误信息字符串指针。 char *tpalloc(char *type, char *subtype, long size) 功 能： 申请内存缓冲区。 输入参数： type 缓冲区类型。 subtype 缓冲区子类型。 size 缓冲区长度。 输出参数： 返 回： 缓冲区指针。 如果失败，则返回空指针。 char *tprealloc(char *bufptr, long size) 功 能： 修改已分配缓冲区长度。 输入参数： bufptr 已分配缓冲区指针。 size 新缓冲区长度。 输出参数： 返 回： 新缓冲区指针。 如果失败，则返回空指针。 void tpfree(char *bufptr) 功 能： 释放已分配缓冲区。 输入参数： bufptr 已分配缓冲区指针。 输出参数： 返 回： int tpchkauth() 功 能： 获取安全认证级别。 输入参数： 输出参数： 返 回： TPNOAUTH 不需要密码。 TPSYSAUTH 需要密码。 TPAPPAUTH 需要密码及应用特别信息。 TPACLAUTH 访问控制表处于活动状态。 其他 失败。 int tpinit(TPINIT *tpinfo) 功 能： 初始化一个应用。 输入参数： tpinfo 初始化信息结构。该结构定义如下： struct { char usrname[32]; （用户名，32字节） char cltname[32]; （终端名称，32字节） char passwd[32]; （密码，前8字节有意义） char grpname[32]; （组名，32字节） long flags; （通知类型及系统访问方式标志） TPU_SIG 选择信号通知。 TPU_DIP 投入式通知（用tpchkunsol()检查）。 TPU_IGN 忽略通知。 TPSA_FASTPATH 系统快捷访问。 TPSA_PROTECTED 系统保护访问。 long datalen; （应用特别信息长度） long data; （应用特别信息索引） } 输出参数： 返 回： -1 失败。 其他 成功。 int tpterm() 功 能： 结束应用。 输入参数： 输出参数： 返 回： -1 失败。 其他 成功。 int tpacall(char *service, char *bufptr, long length, long flags) 功 能： 发送服务请求。 输入参数： service 请求服务名称。 bufptr 发送缓冲区指针。 length 发送缓冲区长度（只有缓冲区类型为CARRAY时需要， 其他均为0）。 flags 标志： TPNOTRAN 交易模式下不调用。 TPNOREPLY 无返回。 TPNOBLOCK 延时不等待。 TPNOTIME 无超时。 TPSIGRSTRT 允许信号。 输出参数： 返 回： -1 失败。 其他 应用服务句柄。 int tpgetreply(int *handle, char **bufpp, long *length, long flags) 功 能： 获取服务返回。 输入参数： handle 由tpacall()返回的应用服务句柄。 flags 标志（与tpacall()相同，另增如下）： TPGETANY 忽略应用服务句柄，接收任意有效返回。 TPNOCHANGE 接收与请求相同类型缓冲区返回。 输出参数： bufpp 接收返回信息缓冲区指针的指针。 length 返回信息长度指针。 返 回： -1 失败。