TongLinkQ使用
- 格式：doc
- 大小：109.00 KB
- 文档页数：4
TongLinkQ使用
一、TongLinkQ安装
在Windows中的安装过程执行默认安装即可，在安装过程中安装程序会自动设置环境变量，安装完毕后提示重新启动。注意：系统重启后安装过程中设置的环境变量才会生效。
Windows下安装过程中设置的环境变量
在CLASSPATH环境变量中添加以下内容（Java程序使用）
C:\Program Files\Tongtech\TLQ72\java\lib\tlclient.jar;
C:\Program Files\Tongtech\TLQ72\java\lib\TLQRemoteApi.jar;
C:\Program Files\Tongtech\TLQ72\java\conf;
C:\Program Files\Tongtech\TLQ72\java\lib\javaee.jar;
C:\Program Files\Tongtech\TLQ72\java\lib\TongJMS.jar;
在Path环境变量中添加以下内容（TLQ的命令和测试程序路径）
C:\Program Files\Tongtech\TLQ72\bin;
C:\Program Files\Tongtech\TLQ72\samples\bin;
新添加的环境变量
TLQCONFDIR = C:\Program Files\Tongtech\TLQ72\etc （配置文件的保存目录）
TLQHOMEDIR = C:\Program Files\Tongtech\TLQ72 （TLQ的家目录）
TLQLICENSEDIR = C:\Program Files\Tongtech\TLQ72 （TLQ的License保存目录）
TLQLOGDIR = C:\Program Files\Tongtech\TLQ72\log （日志文件的保存目录）
TLQMSGDIR = C:\Program Files\Tongtech\TLQ72\msg
TLQRCVFILESDIR = C:\Program Files\Tongtech\TLQ72\rcvfiles （接收文件的目录）
TLQSNDFILESDIR = C:\Program Files\Tongtech\TLQ72\sndfiles （发送文件的目录）
二、TLQ的几个基本概念
1．TLQ节点
安装TLQ服务器端软件的一台主机。
2．QCU队列控制单元 （对应于MQ的队列管理器）
一个TLQ节点上可以包括多个QCU;
一个QCU中可包括多个队列和发送进程、接收进程等
3．队列（包含在QCU中）
系统队列的前缀是TLQ.SYS. 用户自定义的队列不能使用
队列的类型包括：
队列类型 性质
本地队列 物理队列
发送队列
远程队列 逻辑队列（不占用内存或磁盘空间） 集群队列 其中远程队列必须与一个本地发送队列相关联，并指向另外一个节点的QCU中的一个本地队列。
三、TLQ的基本命令
1．TLQ启动与停止
启动 > tlq –cstart
停止 > tlq –cstop （等待全部进程结束后停止）
> tlq –cstart （强制停止）
2．队列控制单元（QCU）的命令
在命令行中敲入tlqqcu 就会显示出全部的命令提示
tlqqcu qcuname -a disp (显示qcu的当前BASIC小节配置)
tlqqcu qcuname -a start/activate (qcu启动、启用)
tlqqcu qcuname -a stop/inactivate <-o normal/abort> <-y> (qcu停止、禁用)
tlqqcu qcuname -a delete <-y> (qcu删除)
tlqqcu qcuname -a add QCUStatus[0/1] configItem[value] ... (增加qcu, QCUStatus - 1正常, 0禁用)
例如：新建一个队列控制单元，名称qcu2
> tlqqcu qcu2 –a add QCUStatus[1]
执行完毕后在% TLQHOMEDIR %\etc目录下会生成tlqcu_qcu2.conf配置文件
3．队列的命令
在命令行中敲入tlqque 就会显示出队列的全部命令提示
tlqque qcuname queuename -a disp (队列属性显示)
tlqque qcuname queuename -a delete/clear<-o normal/abort> <-y> (队列删除、清空)
tlqque qcuname queuename -a add queueType[R/L/S/C] configItem[value] configItem[value] ...
(队列增加，其中队列类型R：为远程队列；L：为本地队列；S：为发送队列；C：为集群队列)
tlqque qcuname queuename -a alter configItem[value] configItem[value] ... (队列属性修改)
例如：在qcu2中创建一个远程队列，可以和其他节点中的队列通讯
建立远程队列时必须指定一个本地发送队列和目的地队列名称（另外一个节点上的队列），因此要先建立一个本地的发送队列
> tlqque qcu2 queSend1 –a add queueType[S] （创建发送队列）
> tlqque qcu2 queRemote1 –a add queueType[R] SendQueName[queSend1]
DestQueName[queLocal1] （创建远程队列，其中queSend1是发送队列，queLocal1是远程节点上的本地队列）
4．发送进程的命令
在命令行中敲入tlqsndproc 就会显示出发送进程的全部命令
tlqsndproc qcuname sndprocId -a disp (显示属性)
tlqsndproc qcuname sndprocId -a start/activate (发送进程的启动、启用)
tlqsndproc qcuname sndprocId -a stop/inactivate <-o normal/abort><-y> (发送进程的停止、禁用)
tlqsndproc qcuname sndprocId -a delete <-y> (发送进程的删除) tlqsndproc qcuname sndprocId -a add sendprocstatus[value] (发送进程增加)
命令中sndprocId 是进程标识，必须为数字；sendprocstatus – 1正常，0禁用
例如：在qcu2中创建一个发送进程
> tlqsndproc qcu2 1 –a add SendProcStatus[1]
5．发送连接的命令
在命令行中敲入tlqsndconn 就会显示出发送连接的全部命令
tlqsndconn qcuname sndconnname -a disp (显示属性)
tlqsndconn qcuname sndconnname -a start/activate (发送连接启动、启用)
tlqsndconn qcuname sndconnname -a delete <-y> (发送连接删除)
tlqsndconn qcuname sndconnname -a stop/inactivate <-o normal/abort><-y> (发送连接停止、禁用)
tlqsndconn qcuname sndconnname -a add sndprocId[xxx] configItem[value] ... (发送连接的增加)
tlqsndconn qcuname sndconnname -a alter configItem[value]... (发送连接属性修改)
发送连接必须与一个发送进程相关联；并且建立时必须指定本地的发送队列名称和被连接的远程节点的IP地址（或主机名）和被连接节点的端口号（该端口号要与被连接节点的接收进程中的监听端口号的值相同）
例如：在qcu2中创建一个发送连接，名称sendconn1
> tlqsndconn qcu2 sendconn1 –a add SndProcID[1] SendQueName[queSend1]
HostName[192.168.1.230] ConnPort[10003]
6．接收进程的命令
在命令行中敲入tlqrcvproc 就会显示出接收进程的全部命令
tlqrcvproc qcuname rcvprocId -a disp (显示属性)
tlqrcvproc qcuname rcvprocId -a start/activate (接收进程的启动、启用)
tlqrcvproc qcuname rcvprocId -a stop/inactivate <-o normal/abort><-y> (接收进程的停止、禁用)
tlqrcvproc qcuname rcvprocId -a delete <-y> (接收进程的删除)
tlqrcvproc qcuname rcvprocId -a add RcvProcStatus[value] ... (接收进程的增加)
tlqrcvproc qcuname rcvprocId -a alter configItem[value] ... (接收进程的修改)
命令中rcvprocId是进程标识，RcvProcStatus – 1正常，0禁用
在创建接收进程时要指定监听端口号ListenPort
例如：在qcu2中创建一个接收进程
> tlqrcvproc qcu2 1 –a add RcvProcStatus[1] ListenPort[10003]
四、配置实例
演示2个TLQ节点的通讯
一个远程队列对应一个发送队列，即一个远程队列发送消息通过一个对应的发送队列进行消息发送。
即应用从节点NodeA 的QCUA 中，通过远程队列RemoteQ 对应的发送队列SendQ 发送消息到远端节点NodeB 的QCUB 的本地队列LocalQ。
