内容发布更新时间 : 2024/6/17 14:04:10星期一 下面是文章的全部内容请认真阅读。

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。