有关TLQ的使用

tlq启动帮助提示

命令行格式

tlq -h|-?|

参数解释

-h：显示帮助信息
-?：显示帮助信息
<>：<>括号里的内容表示是可选项
cmd：为启动或停止命令，默认为启动。
cmd 为 start 时，为 tlq 启动，缺省为 start。即 tlq 或 tlq–cstart；
cmd 为 stop 时, 为等待应用正常停止，TLQ 停止。即 tlq–cstop 或 tlq–cstop -y；
cmd 为 abort 时, 为应用被杀掉强制停止，TLQ 停止。即 tlq–cabort 或 tlq–cabort -y；
time：为等待应用结束的时间，单位为秒；
-y：无提示方式停止 tlq；
若节点启动失败，则所有已经创建的 IPC 资源和核心进程将被清除掉。
启动的核心进程总数不能超过 100 个。
系统运行过程中可用 tlqdebug 工具对启动时的参数进行修改。

tlq停止

命令行格式

tlq -cstop/abort [-y]

参数解释

cstop：等待用户进程退出后系统才退出，否则一直等待；
abort：不等待用户进程退出即系统停止，应用进程被 kill，系统资源被清除，核心进程被 kill，系统停止后，系统占用的资源清除。

调试信息控制工具–tlqdebug

命令行格式

tlqdebug -h|-?| -D<DebugMode>|-d<debuglevel>|-R<RetryTimes>|-t< Retrycount >|

可选参数

-h：显示帮助信息
-?：显示帮助信息
< >：< >括号里的内容表示是可选项
DebugMode：为调试日志模式，主要模式如下：
1 init 2 moni 4 qcumoni 8 qcumng 16 snd 32 rcv64 stat 128 psbroker 256 clibroker 512 spv 1024 jmsbroke 2048 jndibroker
65535 为上面所有信息的调试日志
debugLevel：为调试级别，级别为：0~5。0 为最低级别，5 为最高级别，级别越高日志越详细。
RetryTime：为发送消息重试的时间间隔，单位为秒，缺省值为 30 秒（s）。
Retrycount：为消息回滚或发送消息重试的次数。
上述两项只是针对所有消息的发送，当对方空间不足导致消息无法发送，发送方会每隔
RetryTime 重试，若重试次数超过 Retrycount，消息仍然发送不出，则消息被挪到事件队列中。
对于本地队列中的消息，若回滚次数超过 Retrycount，则消息被放入到事件队列中。
缺省情况下：
Retrycount＝-1
RetryTime = 30
若不输入 Retrycount 和 RetryTime 这两个参数，则系统缺省分别为-1 和 30。
若输入的 Retrycount 为-1，则表示回滚或发送次数无限次。

队列控制单元–tlqqcu

命令行格式

tlqqcu 或 tlqqcu -?

可选参数

tlqqcu qcuname -a disp # 查看QCU详细配置参数，不能显示停止或禁用的QCU，只能显示启动或启用的QCU，但刚启用且没启动的QCU，必须重启 TLQ 系统才能生效，可以用显示命令行工具显示此QCU的【BASIC】小节配置。

tlqqcu qcuname -a stop/inactivate # 停止/禁用一个启动或启用的QCU

tlqqcu qcuname -a delete # 删除qcu,但不能删除正在运行的QCU

tlqqcu qcuname -a start/activate # 启动qcu，启用一个停止或禁用的 QCU。若启用一个停止的 QCU，则重新 TLQ 系统后才能生效；若启用一个禁用的 QCU，则启用的此 QCU 会立即生效。

tlqqcu qcuname -a add QCUStatus[0/1] configItem([value] #新增加一个 QCU，QCU 名不能重名。例如:tlqqcu mikasa -a add QCUStatus[0]

队列模板–tlqquemodel

命令行格式

tlqquemodel 或 tlqquemodel -?

可选参数

tlqquemodel modelname -a disp # 显示系统配置文件 tlsys.conf 中队列模板[QueModel]小节中某一队列模板的配置。

tlqquemodel modelname -a delete <-y> # 删除某一队列模板配置记录小节[QueModelRecord]。

tlqquemodel modelname -a add IsDef[0/1] # 增加一个没有的队列模板配置记录小节[QueModelRecord]，增加的队列模板名不能重名。用显示队列模板配置命令行工具来查看新增加的队列模板。

tlqquemodel modelname -a alter configItem[value]configItem[value] # 修改某一队列模板配置记录小节中的某一个或多个配置参数值。用显示队列模板配置命令行工具来查看修改的配置参数是否正确。

瘦客户代理操作–tlqclibrk

命令行格式

tlqclibrk 或 tlqclibrk -?

可选参数

tlqclibrk qcuName CliBrokerID -a disp # 显示队列控制单元配置文件 tlqcu_qcuname.conf 中瘦客户代理[ClientBroker]小节中某一客户端代理进程编号的配置。

tlqclibrk qcuName CliBrokerID -a start/activate # 启动或启用某一队列控制单元的瘦客户代理。若启用一个停止的瘦客户代理，则重新 TLQ 系统后才能生效；若启用一个禁用的瘦客户代理，则启用的此瘦客户代理会立即生效。进行完启动或启用操作后，可以用显示命令行工具进行查看。

tlqclibrk qcuName CliBrokerID -a stop/inactivate <-o normal/abort> <-y> # 停止或禁用某一队列控制单元的瘦客户代理。 进行完停止或禁用操作后，可以用显示命令行工具进行查看。

tlqclibrk qcuName CliBrokerID -a delete <-y> # 只允许删除一个停止或禁用的瘦客户代理。实例操作:tlqclibrkconnid qcu1 0 mm -a delete

tlqclibrk qcuName CliBrokerID -a add configItem[value] configItem[value] ... # 增加瘦客户代理时，ListenPort 为必输入项且不能与已有的端口号相同，CliBrokerStatus 为可选项，不选缺省值为 0。

tlqclibrk qcuName CliBrokerID -a alter configItem[value] configItem[value]... # 修改瘦客户代理的 ListenPort 和 CliBrokerStatus 两配置项值时，只修改配置文件中的值，若想生效，则重启瘦客户代理进程才能生效。

主题操作–tlqtopic

命令行格式

tlqtopic 或 tlqtopic -?

可选参数

tlqtopic qcuname TopicName -a add configItem[value] configItem[value] # 增加某一队列控制单元主题操作时，必须输入 TopicType[]和 TopicStyle[]两个参数值。实例操作：tlqtopic qcu1 TopicN -a add TopicType[0] TopicStyle[0]

tlqtopic qcuname TopicName -a delete <-y> # 删除某一队列控制单元的主题配置操作。

发布订阅代理操作–tlqpsbrk

命令行格式

tlqpsbrk 或 tlqpsbrk -?

可选参数

tlqpsbrk qcuName -a disp # 显示某一队列控制单元发布订阅代理配置的操作。

tlqpsbrk qcuName -a start/activate # 启动或启用某一队列控制单元的发布订阅代理。 若启用一个停止的发布订阅代理，则重新 TLQ 系统后才能生效；若启用一个禁用的发布订阅代理，则启用的此发布订阅代理会立即生效。进行完启动或启用操作后，可以用显示命令行工具进行查看。

tlqpsbrk qcuName -a stop/inactivate <-y> # 停止或禁用某一队列控制单元的发布订阅代理。进行完停止或禁用操作后，可以用显示命令行工具进行查看。

tlqpsbrk qcuName -a add BrkType[0/1] BrokerName[value] RemoteQueName[value] # 增加某一队列控制单元的上级代理或下级代理，且增加的远程队列名必须存在且不能重名。

tlqpsbrk qcuName -a delete BrkType[0/1] BrokerName[value] #删除某一队列控制单元的上级代理或下级代理。

#使用说明：
BrkType：为代理类型。1 表示上级代理 parentBroker，0 表示下级代理 childBroker。

队列操作–tlqque

命令行格式

tlqque 或 tlqque -?

可选参数

tlqque qcuname queuename -a disp # 显示某一队列控制单元的某一队列类型的配置信息，队列类型包括：远程队列、本地队列、发送队列和集群队列四种类型。

tlqque qcuname queuename -a add queueType[R/L/S/C] configItem[value] configItem[value] ... # 向某个队列控制单元中新增某一队列类型（R 远程队列/L 本地队列/S 发送队列/C 集群队列）。实例操作：tlqque qcu1 rq2 -a add queueType[R] RemoteQueName[rq2] SendQueName[sq] DestQueName[lq]

tlqque qcuname queuename -a delete/clear <-o normal/abort> <-y> # 删除某一队列控制单元中某一队列相关配置。清空某一队列控制单元中某一队列中的消息。

tlqque qcuname queuename -a alter configItem[value] configItem[value] ..
#对某个队列控制单元中某一队列的属性进行修改。实例操作:tlqque qcu1 lq -a alter MsgNum[200] 

#使用说明：
configItem：根据不同的队列类型，此配置项不同；
R：为远程队列；
L：为本地队列；
S：为发送队列；
C：为集群队列。

发送进程–tlqsndproc

命令行格式

tlqsndproc 或 tlqsndproc -?

可选参数

tlqsndproc qcuname sndprocId -a disp # 显示某一队列控制单元中发送进程的相关配置。

tlqsndproc qcuname sndprocId -a start/activate # 启动或启用某一队列控制单元的发送进程。若启用一个停止的发送进程，则重新 TLQ 系统后才能生效；若启用一个禁用的发送进程，则启用的此发送进程会立即生效。进行完启动或启用操作后，可以用显示命令行工具进行查看。

tlqsndproc qcuname sndprocId -a stop/inactivate <-o normal/abort><-y> # 停止或禁用某一队列控制单元的发送进程。进行完停止或禁用操作后，可以用显示命令行工具进行查看。

tlqsndproc qcuname sndprocId -a delete <-y> # 只允许删除一个停止或禁用的发送进程。

tlqsndproc qcuname sndprocId -a add sendprocstatus[value] # 增加某一队列控制单元中发送进程的配置信息。实例操作:tlqsndproc qcu1 2 -a add sendprocstatus[0]
 
#使用说明：
sndprocId：为发送进程的标识。

发送连接–tlqsndconn

命令行格式

tlqsndconn -?

可选参数

tlqsndconn qcuname sndconnname -a disp # 显示某一队列控制单元中发送连接的相关配置。

tlqsndconn qcuname sndconnname -a start/activate # 启动或启用某一队列控制单元的发送连接。若启用一个停止的发送连接，则重新 TLQ 系统后才能生效；若启用一个禁用的发送连接，则启用的此发送连接会立即生效。进行完启动或启用操作后，可以用显示命令行工具进行查看。

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] ...... # 增加某一队列控制单元中某一发送连接的配置信息，必须输入存在的发送队列名且不能被其他发送连接配置和必须输入被连接节点的 IP 或主机名或节点名等这两个配置项。
#实例操作：tlqsndconn qcu1 conn2 -a add sndprocId[3] SendQueName[sq2] HostName[168.1.102.3]

tlqsndconn qcuname sndconnname -a alter configItem[value]...... # 修改某一队列控制单元中发送连接的属性。实例操作:tlqsndconn qcu1 conn2 -a alter ConnPort[10252]

接收进程–tlqrcvproc

命令行格式

tlqrcvproc 或 tlqrcvproc -?

可选参数

tlqrcvproc qcuname rcvprocId -a disp # 显示某一队列控制单元中接收进程的相关配置。

tlqrcvproc qcuname rcvprocId -a start/activate # 启动或启用某一队列控制单元的接收进程。 若启用一个停止的接收进程，则重新 TLQ 系统后才能生效；若启用一个禁用的接收进程，则启用的此接收进程会立即生效。进行完启动或启用操作后，可以用显示命令行工具进行查看。

tlqrcvproc qcuname rcvprocId -a stop/inactivate <-o normal/abort><-y> #停止或禁用某一队列控制单元的接收进程。进行完停止或禁用操作后，可以用显示命令行工具进行查看。

tlqrcvproc qcuname rcvprocId -a delete <-y> # 只允许删除一个停止或禁用的接收进程。

tlqrcvproc qcuname rcvprocId -a add configItem[value] configItem[value]... # 增加某一队列控制单元中接收进程的配置信息，其中接收进程状态 RcvProcStatus 为必输入配置项，其他不输入可为缺省值。实例操作：tlqrcvproc qcu1 2 -a add RcvProcStatus[0]

tlqrcvproc qcuname rcvprocId -a alter configItem[value] configItem[value]... # 修改某一队列控制单元中接收进程属性，其中 ListenPort 不能动态修改，只能手工到配置文件中修改，修改后重启一下 TLQ 系统。实例操作：tlqrcvproc qcu1 2 -a alter RcvProcStatus[1]

# rcvprocId: 为接收进程的标识

应用进程–tlqappprog

命令行格式

tlqappprog 或 tlqappprog -?

可选参数

tlqappprog prgId -a disp # 显示 TLQ 系统应用进程的某一应用程序编号的相关配置。

tlqappprog prgId -a delete <-y> # 删除 TLQ 系统应用进程的某一应用程序编号的相关配置。

tlqappprog prgId -a add configItem[value] ... # 增加 TLQ 系统应用进程的某一应用程序编号的相关配置，add 后面必须输入一个配置参数。实例操作：>tlqappprog 200 -a add PrgName[]

tlqappprog prgId -a alter configItem[value]... # 修改 TLQ 系统应用进程中某一应用程序编号的配置属性。实例操作：tlqappprog 300 -a alter StartType[1]

集群目的队列–tlqcludestque

命令行格式

tlqcludestque 或 tlqcludestque -?

可选参数

tlqcludestque qcuName clusterquename cludestquename -a disp # 显示某一队列控制单元集群目的队列的相关配置。

tlqcludestque qcuName clusterquename cludestquename -a delete <-y> # 删除某一队列控制单元的某一集群目的队列相关配置。

tlqcludestque qcuName clusterquename cludestquename -a add Weight[Value] #增加 TLQ 系统应用进程的某一应用程序编号的相关配置，add 后面必须输入一个配置参数。集群目的队列的增加需要【注意事项】如下：
# 1. 增加的集群目的队列名 cludestquename 必须是本地队列或远程队列。
	1) 若集群队列记录中的功能标志为备份线路，则必须为远程队列；
	2) 若集群队列记录中的功能标志为均衡负载，则可以为本地队列，也可以为远程队列；
	3) 若是远程队列，则远程队列对应的发送队列相关的发送连接类型必须为常连接。
# 2. 增加的负载因子 Weight 的值 Value 必须大于 0 的值。
# 实例操作:tlqcludestque qcu1 ClusterN lq -a add Weight[6]

tlqcludestque qcuName clusterquename cludestquename -a alter Weight[Value] # 修改某一队列控制单元集群目的队列的负载因子配置值。实例操作：tlqcludestque qcu1 ClusterN lq -a alter Weight[9]

配置文件转换工具 --tlqconvert

命令行格式

 tlqconvert [-i]{手工选择目录} [debug,info,error,off]{日志级别}

参数解释

# 1. [i]为可选项，即手工输入 
TLQ63 配置文件所在目录的路径(默认为当前路径)执行命令 tlqconvert -i，程序会提示输入 TLQ63 配置文件所在目录的路径，输入完正确目录的路径后，系统会自动转换此目录下 TLQ63 配置文件，同时将转换后的 TLQ81 配置文件输出到此路径下的 TLQ81Conf 目录下。

# 2.[debug,info,error,off]
其代表涵义分别为：调试信息，正常信息，错误信息，关闭。
此参数是用来设置工具在窗口中输出日志的级别，日志级别信息由高到低的顺序设置，级别越
高，日志所显示的内容越详细。若设定高级别的信息时，则比它低级别的所有信息也都输出。例如：
⚫ 若设定级别为 debug，则显示所有级别的所有信息。
⚫ 若设定级别为 error，则只显示错误信息，如果没有错误，就不会有信息输出。
⚫ 若设定级别为 off， 则不会有任何程序本身的信息输出，但不包括 JDK 的错误信息。
在此工具所在的目录的 DOS 提示符窗口下，有如下几种使用方式：
	#1) 命令行下输入：tlqconvert
为默认正常日志信息级别（info），此级别产生结果是转换工具会自动根据环境变量
的 TLQCONFDIR 找到 TLQ63 的配置文件，并转换 TLQ81 配置文件。
	#2) 命令行下输入：tlqconvert [参数]
日志信息级别将根据参数值来决定，参数取值范围[debug,info,error,off]。
比如：tlqconvert debug
日志级别将被设定为 debug ，此级别产生结果是转换工具会自动根据环境变量中
TLQCONFDIR 找到 TLQ63 的配置文件，并转换 TLQ81 配置文件，日志输出所有日志级
别的所有信息。
	#3) 命令行下输入：tlqconvert -i
默认日志信息级别 info，此级别产生结果是通过用户输入 TLQ63 配置文件路径来获得
TLQ63 的配置文件，并转换 TLQ81 配置文件。
	#4) 命令行下输入：tlqconvert -i [参数]
日志信息级别将根据参数值来决定，参数取值范围[debug,info,error,off]。
比如：tlqconvert -i debug,日志级别将被设定为 debug ，此级别产生结果是通过用户输入 TLQ63 配置文件路径来获得 TLQ63 的配置文件，并转换 TLQ81 配置文件，日志输出所有日志级别的所有信息。

使用说明

# 配置文件转工具 tlqconvert 使用说明如下：
# 1. JAVA 环境：需要 JDK1.4 或以上版本。
# 2. 支持操作系统：支持 Windows 和 UNIX。
# 3. TLQ63 的配置文件必须在环境变量 TLQCONFDIR 指定的目录下。
# 4. 从 cmd 窗口进入到 tlqconvert.bat 文件所在的目录，执行命令 tlqconvert，系统会自动把 TLQ63 配置文件转换成 TLQ81 配置文件，并输出到当前路径下的 TLQ81Conf 目录下。
# 5. 所有涉及下级节点配置，需要提供该节点的下级节点的配置文件 TongDownNode.Conf 且也在环境变量 TLQCONFDIR 指定的目录下，其内容格式"节点名,IP 地址,端口号" 可多行，
如:"DN_A,198.129.100.1,10240。
# 6. 转换后的 TLQ81 配置文件中的参数后面不带注释。

配置文件加解密工具 --tlqcrypt

命令行格式

tlqcrypt -[e|d] <fnameIn> <fnameOut>

可选参数

# 1、-[e|d]
-e：该参数是对配置文件进行加密的选项
-d：该参数是对配置文件进行解密的选项
# 2、<fnameIn>
-e 参数时，该文件是被加密的配置文件
-d 参数时，该文件是被解密的配置文件
# 3、<fnameOut>
-e 参数时，该文件是加密后生成的配置文件，文件名由用户指定
-d 参数时，该文件是解密后生成的配置文件，文件名由用户指定

使用说明

# 配置文件加解密工具 tlqcrypt 使用说明如下:
# 1、JAVA 环境：需要 JDK1.4 或以上版本。
# 2、支持操作系统：支持 Windows 和 UNIX。
# 3、配置文件必须在环境变量 TLQCONFDIR 指定的目录下。
# 4、执行命令 tlqcrypt，系统会把配置文件进行加密或解密操作，并输出到 TLQCONFDIR 指定的目录下。