ATMI：Application-to-Transaction Monitor Interface。
1.tpchkauth
int tpchkauth();
在调用tpinit()之前检查是否需要认证和认证的级别。
返回值：
TPNOAUTH：不需要认证；
TPSYSAUTH：系统认证，需要密码；
TPAPPAUTH：应用认证，需要密码和特殊应用数据；
当返回值为TPSYSAUTH和TPAPPAUTH时，我们必须使用tpalloc()分配一个TPINIT结构，在该结构中填入认证数据，然后用该结构作为参数调用tpinit()。
失败原因主要有：
协议错；
操作系统错；
tuxedo底层错。
2.tpinit
在使用tuxedo其他服务之前，必须调用tpinit加入到应用中。
int tpinit(TPINIT *tpinfo);
参数说明：
tpinfo：指向TPINIT类型的指针。
TPINIT类型在atmi.h中有定义，如以下几个域：
char usrname [32]; (32 characters significant)
char cltname [32]; (32 characters significant)
char passwd [32]; (8 characters significant)
char grpname [32]; (32 characters significant)
long flags;
long datalen;
long data;
usrname：用户名或login名；
cltname：应用定义；
passwd：应用密码；
grpname：在事务中使用，必须在配置文件定义的组列表中；
flags：定义请求/通知类型和系统存取方法，其中TPU_SIG、TPU_DIP和TPU_IGN不能同时指定；TPSA_FASTPATH和TPSA_PROTECTED不能同时指定。有如下的值：
TPU_SIG：选择信号通知；
TPU_DIP：选择dip-in通知；
TPU_IGN：忽略通知；
TPSA_FASTPATH：选择fastpath方式系统存取；
TPSA_PROTECTED：选择protected方式系统存取；
datalen：应用特殊数据的长度；
data：应用特殊数据；
域flags的值覆盖���统的缺省定义，前提是在配置文件中没有指定NO_OVERRIDE。
如果参数使用(TPINIT*)NULL，则client使用系统缺省的通知设置和系统存取设置，若需要认证，则出错返回TPEPERM。
tpinit()调用失败返回-1，失败原因有：
参数错；
没有空间在BB；
没有权限；
协议错；
操作系统错；
tuxedo底层错。
示例：
TPINIT *tpinfo;
char password[9];
/* prompt user for password */
if ((tpinfo = (TPINIT *)tpalloc(“TPINIT”, NULL,
TPINITNEED(0))) == NULL) {
(void)userlog(“unable to allocate TPINIT buffer”);
exit(1);
}
(void)strcpy(tpinfo->passwd, password);
(void)strcpy(tpinfo->usrname, “Smith”);
(void)strcpy(tpinfo->cltname, “Teller”);
tpinfo->flags = (TPU_DIP|TPSA_PROTECTED);
if (tpinit(tpinfo) == -1) {
(void)userlog(“failed to join application”);
tpfree((char*)tpinfo);
exit(1);
}
当前位置：
论坛首页 »
自由讨论区 »
MQ, Tuxedo及OLTP讨论区
»
发起投票
技术讨论
加好友
发消息
2012-12-20 12:11:16 |
赞(
操作
