1、建立连接WSH(Workstation Handler)TUXEDO系统自带的一个SERVER,由它处理WSC与TUXEDO SERVER之间的通讯。Bulletin Board(公告板)TUXEDO把系统的配置保存在一个共享内存中,该共享内存称为公告板(BB)BBLTUXEDO的经管进程,主要对公告板等进行经管Workstation Client与TUXEDO SERVER建立连接的过程为:1 WSC 调用tpinit()或tpchkauth()2 WSC采用在WSNADDR中指定的IP地址与服务端的WSL建立连接3 WSL为该WSC指定一个WSH,并把该WSH的侦听端口返回给WSC4 WS
2、C采用返回的端口与指定的WSH建立连接,并与WSL断开连接,这之后WSC与TUXEDO SERVER之间的通讯通过WSH进行处理,与WSL无关。5 tpinit()或tpchkauth()调用返回。本地客户端与远程客户端的主要区别1. 本地客户端只能用C语言或COBAL语言编写,远程客户端可以用几乎所有的编程语言编写。2. 在远程客户端所在的机器上要安装TUXEDO的客户端软件,并且在设置相应的环境变量;在本地客户端上不用3. 用buildclient编译远程客户端程序时要加 W,编译本地客户端则不用与远程客户端有关的配置:1 在MACHINES中要配置MAXWSCLIENTS,即最多可以有多
3、少个远程客户端同时连接到该服务器上。2 在SERVERS中要配置SERVER:WSLWSL SRVGRP=GROUP1 SRVID=1116 CLOPT=-A - -n /192.168.120.113:8888 -m 2 -M 5 -x 6CLOPT中可带的参数为: -A servopts_options - -n netaddr -d device -w WSHname-t timeout_factor-T Client_timeout -m minh-M maxh-x mpx_factor -p minwshport-P maxwshport -I init_timeout-c comp
4、ression_threshold -k compression_threshold -z bits-Z bits-H external_netaddr -N network_timeout-Kclient|handler|both|none参数说明:-n netaddr: WSL的侦听端口,远程客户端通过该端口与服务器建立连接-m minh : 最少启动多少个WSH进程-M maxh: 最多启动多少个WSH进程,默认值为MAXWSCLIENTS/m-x mpx_factor:每个WSH进程可以同时与多少个远程客户端建立连接-c compression_threshold如果在远程客户端与服务
5、器之间传送的数据包大小(单位为字节)超过-c指定的参数,就自动进行数据压缩,-T Client_timeout: 指定一个远程客户端的空闲时间,如果该远程客户端在client_timeout这么长的时间内没有做任何调用,WSH将断开与该远程客户端的连接。单位为分钟,如果没有指点该参数,那么WSH永远不会自动断开远程客户端的连接-t timeout_factor: 指定远程客户端与WSH建立连接的时间,如果在-t指定的时间内还没有建立连接,那么连接将失败。如果没有采用安全认证方式默认为3*SCANUNIT秒,。如果采用安全认证方式默认为6*SCANUNIT秒,-p minwshport-P ma
6、xwshport:指定WSH可以使用的端口范围:如果远程客户端要跨越防火墙才能访问该TUXEDO应用系统,在WSL中要指定该参数,指定WSH可以使用的端口范围,并让防火墙允许访问这些端口。如果不指定,TUXEDO会根据系统端口的使用情况进行分配,而分配的端口防火墙不允许通过,造成CLIENT无法调用TUXEDO SERVER。如下面的设置指定WSH可用的端口范围为17010 17030。WSL SRVGRP=GROUP1 SRVID=1 CLOPT=-A - -n /133.101.6.26:17009 -m 10 -M 10 -x 10 -p 17010 -P 17030在远程客户端的机器上
7、要设置的环境变量TUXDIR (必需):TUXEDO客户端在该机器上的安装目录WSNADDR(必需):远程客户端通过该IP地址与服务器建立连接,它的值为-n参数的值,如在上面的配置中为:SET WSNADDR= /192.168.120.113:8888WSTYPE(可选): 该客户端的类型,如果与服务器的类型一样,那么在它们之间进行数据传送时不用进行编码解码工作。其他不常用的环境变量可参考TUXEDO的联机文档。客户端的编程模式:在3层结构中,CLIENT是属与表示层,表示层主要处理与用户交互,它的功能可概括为:1、提供应用的用户交互接口,即主要通过图形化的用户界面,取的用户的输入数据2、与
8、TUXEDO 应用服务器建立连接3、调用TUXEDO应用服务器上的服务(SERVICE),把客户端的输入参数放入输出缓冲区。4、TUXEDO应用服务器调用相应的SERVICE处理客户端的请求,把处理结果通过客户端的输入缓冲区返回给客户端。 客户端与服务端之间的通讯方式有以下几种:1、同步调用:2、异步调用3、会话方式:4、可靠消息队列5、广播方式6、发布/订阅在下一章我们再具体介绍7.2 CLIENT的ATMI介绍客户端通过调用TUXEDO提供的编程API(ATMI)来编写程序,下面介绍一些客户端主要的ATMI与连接的建立与断开有关的ATMI为了与TUXEDO SERVER建立连接,TUXED
9、O CLIENT要调用TPCHKAUTH()检查该TUXEDO SERVER所采用的安全方式,并根据得到的值做相应的处理,然后调用TPINIT()建立与TUXEDO的连接,在TUXEOD SERVER的结果返回之后,调用TPTERM()断开与TUXEDO SERVER的连接.int tpchkauth()描述: 检查该TUXEDO SERVER所采用的安全方式参数:无返回值: TPNOAUTH:不需要认证 TPSYSAUTH:需要口令认证 TPAPPSUTH:需要口令认证,并且还需要应用级的认证或授权. -1:调用失败, 错误号保存在全局变量tperrno中。int tpinit(TPINIT
10、 *tpinfo) 与TUXEDO SERVER建立连接TPINFO 失败返回-1, 错误号保存在全局变量tperrno中。TPINIT结构体在atmi.h中的定义如下struct tpinfo_t char usrnameMAXTIDENT+2。 /* client user name */ char cltnameMAXTIDENT+2。 /* application client name */ char passwdMAXTIDENT+2。 /* application password */ chargrpnameMAXTIDENT+2。 /* client group name *
11、/ long flags。 /* initialization flags */ long datalen。 /* length of app specific data */ long data。 /* placeholder for app data */。typedef struct tpinfo_t TPINIT。说明:username,cltname,passwd,grpname,data,datalen用于安全认证中flags:用于定义以何种方式通知该客户端一个UNSOLICTED MESSAGE的到来.它的值可以为:TPU-SIGTPU-DIPTPU-IGNTPSA-FASTPA
12、THTPSA-PROTECTEDint tpterm() 断开与TUXEDO SERVER建立连接与请求TUXEDO SERVER 有关的ATMIint tpcall(char *svc, char *idata, long ilen, char *odata, long *olen, long flags)描述:客户端同步调用服务端的名为svc的SERVICE,参数:*svc:SERVICE的名称char *idata: 输入缓冲区的地址,客户端传给服务端的参数放在该缓冲区内long ilen: 输入缓冲区的长度char *odata 输出缓冲区的地址,服务端传给客户端的结果放在该缓冲区内l
13、ong *olen:输出缓冲区的长度 long flags: 调用标志,由以下几个:TPNOTRAN如果调用svc的客户端当前在TRANSACTION方式下,那么svc不参与当前的TRANSACTION。TPNOCHANGE如果服务端返回的缓冲区类型与客户端定义的缓冲区(odata)类型不一致,默认情况下,odata会转换成与服务端返回的缓冲区类型一致的类型,如果设置了该FLAG,那么当出现这种情况时,不进行缓冲区类型转换,并且会保错。TPNOBLOCK默认情况下,如果客户端有阻塞条件存在(如CLIENT的TCP/IP中的缓冲区满,磁盘I/O忙等),那么客户端会阻塞在那里,直到阻塞消除或超时出错。如果设置了TPNOBLOCK,当客户端有阻塞条件存在时,TPCALL()会立刻返回并报错. 注意TPNOBLOCK只对发送请求时起作用,如果在接收服务端返回的结果时有阻塞条件存在,客户端会在那里等待,直到阻塞消除或超时出错TPNOTIME如果客户端有阻塞条件存在,客户端会一直阻塞在那里,即使到了超时时间也不返回,但如果该客户端是在TRANSACTION模式下,当到了事务的超时时间,还是会报超时错误并返回。TPSIGRSTRT如果在进行系统调用时,被信号中断,该系统调用会重新进行。调用成功返回0,失败返回-1,
copyright@ 2008-2022 冰豆网网站版权所有
经营许可证编号:鄂ICP备2022015515号-1