下载文档原格式
T o n g T ech®TongLINK/Q8.1技术白皮书东方通科技中间件技术白皮书（1）目录1.前言 (2)2.企业级应用的传输需求 (2)3.TongLINK/Q简介 (3)4.TongLINK/Q8.0主要新增功能特性 (3)5.TongLINK/Q体系结构 (4)5.1. 产品组成 (4)5.2. 节点 (5)5.3. 监控管理中心 (6)5.4. 开发接口 (6)6.TongLINK/Q基本功能 (6)6.1. 应用构建模式 (6)6.2. 消息传递模式 (8)6.3. 节点组织模式 (9)6.4. 通道连接方式 (9)6.5. 异步通讯机制 (9)6.6. 消息管理 (9)6.7. 队列管理 (10)6.8. 压缩加密 (11)6.9. 支持SSL (12)6.10. 断点续传 (12)6.11. 流量控制 (12)6.12. 集群功能 (12)6.13. 事件功能 (13)6.14. 事务管理 (13)6.15. 应用管理 (13)6.16. 客户端活动连接数监控和限制 (13)6.17. 日志管理 (13)6.18. 配置监控管理 (14)6.19. 安全 (14)6.20. 支持JMS1.1 (15)6.21. 支持JMS传文件和组消息 (15)6.22. 应用接口 (15)7.TongLINK/Q产品特点 (16)7.1. 可靠性 (16)7.2. 高效性 (16)7.3. 安全性 (16)7.4. 可用性 (16)7.5. 可扩展性 (16)7.6. 开放性 (17)7.7. 可管理性 (17)8.解决方案 (17)8.1. 联合审批系统 (17)8.2. 股票信息发布系统 (19)8.3. 与应用服务器的集成 (19)1.前言随着计算机技术的发展，分布式应用系统的应用日益广泛，在这样的环境中，无论硬件还是软件平台都不可能做到统一。
大规模的应用软件通常要求在软、硬件各不相同的分布式网络上运行，由此出现了不同硬件平台、不同网络环境、不同数据库之间的互操作。
联锁问题排查方案随着软件开发技术的不断发展，软件系统也变得越来越复杂。
为了确保软件系统能够稳定可靠地运行，开发人员通常会对软件进行大量测试和调试。
在软件系统中，联锁是一种非常常见的机制，用于限制不同模块之间的交互以及防止意外的状态变化。
当软件系统出现联锁问题时，可能会导致系统崩溃、数据丢失、用户信息泄露等严重后果。
因此，如何及时发现并解决联锁问题，是每个软件开发人员必须面对的重要问题。
什么是联锁在软件系统中，联锁（Interlock）是一种设计模式，用于控制或限制不同模块之间的交互。
通过使用联锁，可以确保只有特定的对象能够访问或修改某些资源，从而保证系统的可靠性和安全性。
具体来说，在软件系统中，联锁通常使用锁（Lock）或信号量（Semaphore）来实现。
当两个不同的模块需要同时操作同一个资源时，为了避免出现数据竞争和错误的状态转移，这些模块必须按照固定的顺序进行访问。
例如，如果两个线程需要同时访问同一个数据结构，那么它们必须按照特定的顺序获得和释放锁，以避免发生冲突和错误。
联锁问题的常见表现尽管联锁在软件系统中是一种非常常见的机制，但是由于其设计和实现的复杂性，联锁问题也经常出现。
下面列举了一些常见的联锁问题：1.死锁（Deadlock）：两个或多个线程相互等待对方释放资源时，会出现死锁情况，从而导致系统无法继续运行。
2.活锁（Livelock）：当两个或多个线程进入一种忙等待的状态时，会出现活锁情况。
这种情况下，线程会不断地检查某些条件，但是无法进一步执行。
3.竞争条件（Race Condition）：当两个或多个线程同时访问、写入同一数据时，可能会导致竞争条件，从而导致数据不一致或错误的状态转移。
4.饥饿（Starvation）：某个线程一直无法获得所需的资源，从而一直处于等待的状态，这种情况被称为饥饿。
联锁问题的排查方案为了解决联锁问题，开发人员需要进行一系列的排查和调试。
下面介绍了一些常用的联锁问题排查方案：1. 记录日志在软件系统中，日志（Log）是一种非常重要的工具，可用于记录系统的状态和运行信息。
![[3]TLQ8.0产品培训-开发环境](https://img.taocdn.com/s1/m/2c66fb592b160b4e767fcf4b.png)
TongTech®TongLINK/Q8.1系统开发手册-程序设计指南2011年8月TongLINK/Q V8.1系统开发手册_程序设计指南北京东方通科技股份有限公司地址：北京市海淀区彩和坊路10号1+1大厦2、3层客户服务热线：400-650-7088Email：版权声明版权©2006-2016东方通科技版权所有。
版权保护说明未经东方通科技公司书面许可，本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。
本文档中的信息可能不加通知进行修改。
商标©2006-2016东方通科技版权所有。
、TongTech、TongLINK、TongLINK/Q、Tong Integrator、Tong SEC、Tong Web、Tong EASY、Tong Workflow是东方通科技的注册商标。
其他所有的公司和产品名称可能为第三方所有。
前言本手册主要对程序设计指南有关应用程序设计概述、消息介绍、技术及队列准备、消息描述及消息操作选项设计、消息体数据用户自定义属性设计、连接上下文参数设计、应用程序编写、消息操作相关程序编译、配置文件的编辑约束、配置相关数据结构、配置文件动/静态配置、配置文件相关编程和编译、使用Java进行配置文件的编辑等进行说明。
1. 阅读对象本手册面向消息中间件TongLINKQ8.1产品用户以及对消息中间件感兴趣的读者。
2.手册约定本手册遵循以下约定：●手册中所有的队列控制单元简称为QCU。
●手册中所有的消息中间件TongLINK/Q8.1简称为TLQ。
●此手册适用于UNIX &Windows。
●手册中<TongLINK/Q-Root>为TongLINK/Q8.1缺省安装路径。
●下面相关技术文档中的蓝色字体，表示当前阅读文档。
3.相关技术文档●《TongLINKQ8.1快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。
s8000系统常见故障排查案例一案例一：：故障现象故障现象：：登录S8000系统显示***机组不在线机组不在线（（即没有实时数据即没有实时数据））故障故障处理处理：1）、请维护人员到现场检查NET8000 的是否处于正常工作状态，包括：NET8000供电是否正常、网线是否松动。
2)、若供电、网线正常，请检查NET8000 前面板指示灯。
指示灯代表的含义如下（详细的指示灯说明请见《S8000大型旋转机械在线状态监测和分析系统使用手册》第二部分第二章）：A 、PWR （电源指示灯）：若电源指示灯绿色则说明NET8000 供电正常，若电源灯不亮，请检查NET8000 的供电情况。
B 、OK （设备指示灯）：若ok 灯为绿色则表示NET8000主机正常工作。
否则NET8000主机整机未正常工作，出现此种情况请联系本公司售后服务人员。
C 、LAN （网络指示灯）：LAN 灯显示为绿色时表示NET8000 与上级服务器的网络是正常的，若为红色则表示与服务器失去联系，请检查与网络相关的设备，如网线接口是否松动，网线有无损坏、网络通路是否出现故障等；判断网络是否正常的方法如下：在WEB 服务器上或者厂内局域网的一台电脑上，点击“开始”—〉“运行”，如图一：图一输入“cmd ”，如图二：图二输入命令：ping ***.***.***.***(NET8000 的IP 地址)，如图三：图三图三的响应说明网络正常，否则图四响应，则说明是网络的问题，需要检查网络。
如以上方法不能解决问题如以上方法不能解决问题，，请联系我请联系我公司售后服务人员公司售后服务人员公司售后服务人员。
案例二案例二：：故障现象故障现象：：打开S8000 系统看不到图谱数据时系统看不到图谱数据时，，如何解决如何解决？？故障处理故障处理：：请按照以下的步骤检查 ：1、按照上面的第一个问题，判断是否是网络的原因；2、网络检查过后没有异常，请检查在服务器上浏览图谱是否正常，数据是否正常；3、服务器上数据若异常请先把服务器的IIS 服务重新启动并检查S8KCentral程序是否正常运行，刷新网页后察看是否恢复正常；若服务器没有配置显示器和键盘鼠标时，可以通过终端的方式连接到服务器察看，若用户的电脑是Windows XP 的系统，通过XP系统自带的远程桌面连接终端到服务器。
TongLINK/Q常见问题处理指南北京东方通科技支持服务中心目录1.引言12.故障处理前期准备23.故障处理流程23.1.故障处理流程23.2.节点运行诊断流程33.2.1.操作系统核心参数43.2.2.TongLINK/Q环境变量43.2.3.查看TongLINK/Q配置文件53.2.4.查看系统资源和进程63.2.5.查看TongLINK.sys文件73.3.网络连接诊断流程83.3.1.网络层连通性诊断83.3.2.使用TongLINK/Q命令检测节点间的连通性93.4.检查队列中的消息103.4.1.检查错误日志TongLink.sys114.【附录】124.1.常用系统命令124.2.核心参数124.3.SETP文件D EMO131.引言TongLINK/Q的常见故障主要出现在基于TongLINK/Q架构的应用系统运行时。
此文档将重点描述如何判断和处理TongLINK/Q常见的故障问题。
2.故障处理前期准备在进行故障处理之前，必须先了解TongLINK/Q运行环境的相关信息，具体的信息需求如表格所示：图2.1故障处理需求表注：1、表格中红色字体选项是东方通科技公司支持服务中心人员进行故障处理时必须了解的信息；2、“TongLINK/Q架构模式”包括多节点、转发、集群、订阅/发布、JMS等；3.故障处理流程3.1. 故障处理流程TongLINK/Q故障处理顺序如下：查看节点运行情况、查看网络运行状况、判断队列中消息运行情况、查看应用日志判断故障等；具体的总流程如下：图3.0 故障处理总流程3.2. 节点运行诊断流程在处理TongLINK/Q可能出现的问题时，首先需要要确保客户方和服务方的TongLINK/Q正常运行，网络连接正常，并且机器资源够用。
具体的处理流程如下图3.2所示：图3.1 节点运行诊断流程每一检查点的具体步骤描述将在下文具体描述。
3.2.1.操作系统核心参数操作系统核心参数的大小会影响TongLINK/Q的正常运行（包括启动）。
T o n g L i n k Q常见问题处理指南TongLINK/Q常见问题处理指南北京东方通科技支持服务中心目录1.引言 (3)2.故障处理前期准备 (3)3.故障处理流程 (4)3.1.故障处理流程 (4)3.2.节点运行诊断流程 (4)3.2.1.操作系统核心参数 (5)3.2.2.TongLINK/Q环境变量 (5)3.2.3.查看TongLINK/Q配置文件 (6)3.2.4.查看系统资源和进程 (7)3.2.5.查看TongLINK.sys文件 (8)3.3.网络连接诊断流程 (9)3.3.1.网络层连通性诊断 (9)3.3.2.使用TongLINK/Q命令检测节点间的连通性 (10)3.4.检查队列中的消息 (11)3.4.1.检查错误日志TongLink.sys (12)4.【附录】 (13)4.1.常用系统命令 (13)4.2.核心参数 (13)4.3.SETP文件D EMO (14)1.引言TongLINK/Q的常见故障主要出现在基于TongLINK/Q架构的应用系统运行时。
此文档将重点描述如何判断和处理TongLINK/Q常见的故障问题。
2.故障处理前期准备在进行故障处理之前，必须先了解TongLINK/Q运行环境的相关信息，具体的信息需求如表格所示：图2.1 故障处理需求表注：1、表格中红色字体选项是东方通科技公司支持服务中心人员进行故障处理时必须了解的信息；2、“TongLINK/Q架构模式”包括多节点、转发、集群、订阅/发布、JMS等；3.故障处理流程3.1. 故障处理流程TongLINK/Q故障处理顺序如下：查看节点运行情况、查看网络运行状况、判断队列中消息运行情况、查看应用日志判断故障等；具体的总流程如下：图3.0 故障处理总流程3.2. 节点运行诊断流程在处理TongLINK/Q可能出现的问题时，首先需要要确保客户方和服务方的TongLINK/Q正常运行，网络连接正常，并且机器资源够用。
TongTech®TongLINK/Q8.0系统常见问题排除手册2011年1月TongLINK/Q V8.0系统常见问题排除手册北京东方通科技股份有限公司地址：北京市海淀区彩和坊路10号1+1大厦2、3层客户服务热线：400-650-7088Email：版权声明版权©1993-2011东方通科技版权所有。
版权保护说明未经东方通科技公司书面许可，本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。
本文档中的信息可能不加通知进行修改。
商标©1993-2011东方通科技版权所有。
TongTech、TongLINK/Q、TongEASY、TongWeb、TongIntegrator、TongSEC、TongWorkflow、TongGTP、MBP是东方通科技的注册商标。
其他所有的公司和产品名称可能为第三方所有。
前言本文档主要介绍系统启动常见问题、应用程序的常见问题及管理控制台的常见问题等进行分类说明。
1. 阅读对象本手册面向消息中间件TongLINKQ8.0产品用户以及对消息中间件感兴趣的读者。
2.手册约定本手册遵循以下约定：z手册中所有的队列控制单元简称为QCU。
z手册中所有的消息中间件TongLINK/Q8.0简称为TLQ。
z此手册适用于Windows。
z下面相关技术文档中的蓝色字体，表示当前阅读文档。
3.相关技术文档z《TongLINKQ8.0快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。
z《TongLINKQ8.0系统安装手册_管理控制台安装》主要介绍TLQ管理控制台安装的环境、安装过程、有关环境变量设置、TLQ控制台服务器的启动及TLQ管理控制台的登录等。
z《TongLINKQ8.0系统安装手册_服务端安装》主要介绍系统安装的环境、系统安装过程、系统有关环境变量配置、系统的启动、License 相关说明、系统的停止及系统日志说明等。
z《TongLINKQ8.0系统概述》主要介绍消息中间件产品的系统功能及特点、系统结构架构、基本概念、队列控制单元、消息管理、发布订阅、集群、网络传输、SSL安全传输、安全出口、事务、事件管理、应用程序管理、系统管理、目录管理等。
z《TongLINKQ8.0系统开发手册_C编程参考》主要介绍C接口有关的应用编写中用到的相关宏、数据结构及函数定义等。
z《TongLINKQ8.0系统开发手册_C#编程参考》主要介绍C#提供的结构和C#提供的类等有关说明。
z《TongLINKQ8.0系统开发手册_程序设计指南》主要介绍有关应用程序设计概述、消息介绍、技术及队列准备、消息描述及消息操作选项设计、消息体数据用户自定义属性设计、连接上下文参数设计、应用程序编写、消息操作相关程序编译、配置文件的编辑约束、配置相关数据结构、配置文件动/静态配置、配置文件相关编程和编译、使用Java进行配置文件的编辑等。
z《TongLINKQ8.0系统开发手册_安全出口编写指南》主要介绍安全出口概述、配置、编写及编程模式等。
z《TongLINKQ8.0系统开发手册_JA V A编程参考》主要介绍JA V A编程有关概述、相关配置、BaseClass相关的类和使用BaseClass编程等进行说明。
z《TongLINKQ8.0系统管理手册_管理控制台》主要介绍管理控制台使用说明、用户管理、组管理及节点管理等。
z《TongLINKQ8.0系统管理手册_配置管理》主要介绍有关系统运行、参数配置、参数配置项约束、参数配置举例、系统日志等。
z《TongLINKQ8.0系统管理手册_系统工具》主要介绍系统监视工具tlqstat、系统对象控制工具、错误信息查看工具及IPC资源查询工具等。
z《TongLINKQ8.0客户端使用手册》主要介绍客户端的基本概念、客户端UNIX和Windows的安装、系统目录结构、参数配置、代理操作、通讯安全及系统日志等。
z《TongLINKQ8.0系统常见问题排除手册》主要介绍系统启动常见问题、应用程序的常见问题及管理控制台的常见问题等。
z《TongLINKQ8.0系统性能调优手册》主要介绍服务端系统性能调优和客户端性能调优等方面说明。
z《TongLINKQ8.0系统开发手册_JMS编程参考》主要介绍TongLINK/Q JMS应用体系结构、JA V A目录说明、使用TLQJMS程序的步骤、TLQJMS程序配置说明、TLQJMS环境设置、编写TLQ JMS程序、编写发布订阅应用、JMS 消息、JMS中的加密&压缩、JMS的接口、使用基于TLQJMS的MDB及常见问题等进行说明。
z《TongLINKQ8.0系统开发手册_客户端集群编程参考》主要介绍客户端集群简介、客户端集群相关参数配置、C客户端集群接口相关内容及JMS客户端集群接口相关内容等信息。
4.对此版本新增和更改的内容TLQ8.0版本在TLQ7.2版本基础上增加的内容如下：1)第3章新增“在Windows7中，管理控制台强制方式停止有问题”的内容，请参见3.2.2小节说明。
2)第5章新增5.2小节，请参见安装包生成的comfra.properties配置文件不允许跨平台复制小节。
目录第1章系统启动常见问题 (1)1.1网络连接失败 (1)1.2LICENSE.DAT文件不存在 (1)1.3TLQ_VER.DAT文件不存在 (1)1.4缺少TLSYS.CONF文件 (2)1.5缺少TLQCU_QCU1.CONF文件 (2)1.6TLQ的安装路径不存在或不正确 (2)1.7日志文件夹不存在或被删除 (3)1.8接收文件夹不存在或被删除 (3)1.9发送文件夹不存在或被删除 (3)1.10消息文件夹不存在 (3)1.11TL_MONI.EXE文件被损坏 (4)1.12TL_QMONI.EXE文件被损坏 (4)1.13TL_QMNG.EXE文件被损坏 (4)1.14TLQ.EXE文件被损坏 (5)1.15本地节点名称没有填写或者命名不符合规定 (5)1.16P ROGRAM M AX N UM配置项赋值不符合规定 (5)1.17I NSTANCE M AX N UM配置项赋值不符合规定 (6)1.18Q UE M ODEL M AX N UM配置项赋值不符合规定 (6)1.19S END P ROC M AX N UM配置项赋值不符合规定 (7)1.20R ECV P ROC M AX N UM配置项赋值不符合规定 (7)1.21C LI B RK M AX N UM配置项赋值不符合规定 (7)1.22L ISTEN P ORT配置项赋值不符合规定 (8)1.23QCUN AME配置项赋值不符合规定 (8)1.24QCUS TATUS为禁止状态 (9)1.25Q UE M ODEL N AME配置项赋值不符合规定 (9)1.26M SG N UM配置项赋值错误 (9)1.27M SG S IZE配置项赋值错误 (10)1.28Q UE D ATA B UFF配置项赋值错误 (10)1.29P RG ID配置项赋值错误 (11)1.30P RG T YPE配置项赋值错误 (11)1.31S TART T YPE配置项赋值错误 (11)1.32Q UE S END B UFF配置项赋值错误 (12)1.33Q UE R ECV B UFF配置项赋值错误 (12)1.34发送队列名S END Q UE N AME没定义 (13)1.35本地队列名L OCAL Q UE N AME没定义 (13)1.36配置的集群对应的目的队列名与连接类型不匹配 (13)1.37远程队列对应的发送队列没定义 (14)1.38集群对应的目的队列名只能为远程队列或本地队列 (14)1.39客户端配置的H OST N AME和L ISTEN P ORT与服务端不符 (14)1.40内存空间不足 (14)1.41向前调时间 (15)1.42设置的连接类型C ONN T YPE无效 (15)1.43T LQSTAT 显示QCU 名无效 (15)1.44共享内存映射错误 (16)第2章应用程序 (17)2.1应用发送消息常见问题 (17)2.1.1输入不存在或无效的QCU (17)2.1.2输入不存在或无效的队列名 (17)2.1.3优先级不在有效范围内 (17)2.1.4主题名不存在 (17)2.1.5发送文件时,找不到指定的文件 (18)2.1.6发送大消息或文件 (18)2.1.7消息超长 (18)2.2应用接收消息常见问题 (18)2.2.1接收消息时只能为本地队列类型 (18)2.2.2应用实例最大有效个数太小 (19)2.2.3信号灯池的最大数 (19)2.2.4主题名不存在 (19)2.2.5接收端路径设置非法 (19)2.3其他 (20)2.3.1退出tlqstat监控命令 (20)2.3.2恢复消息时，RecvHistoryMsgNum的值配置太小 (20)2.3.3消息超时 (20)第3章管理控制台 (22)3.1动态监控常见问题 (22)3.1.1系统连接超时 (22)3.1.2系统连接被拒绝 (22)3.1.3动态删除队列失败 (22)3.1.4动态打开发送队列失败 (22)3.1.5动态创建客户端代理超过最大数目 (23)3.1.6动态创建集群目的队列不成功 (23)3.1.7动态删除集群目的队列时 (24)3.1.8集群目的队列名称不存在 (24)3.1.9代理名称重复 (24)3.1.10缺省队列模板只能设置一个 (24)3.1.11新建已存在的缺省队列模板 (25)3.1.12代理名称重复 (25)3.1.13配置的远程队列重复 (25)3.1.14输入的队列控制单元名不存在 (26)3.2其他 (26)3.2.1在Windows2003中，创建的接收进程的端口号1025有问题 (26)3.2.2在Windows7中，管理控制台强制方式停止有问题 (27)第4章瘦客户 (31)4.1JA V A不能加载JTLQ_CLIENT动态库 (31)4.2JA V A虚拟机异常退出或数据包错乱 (31)4.3内存不断增长或SOCKET连接不够用 (31)4.4有大量丢消息的现象 (32)4.5瘦客户重连错误号 (32)4.6B ROKER I D 无效 (32)4.7发消息失败 (32)第5章安装包 (33)5.1安装包可执行文件执行弹框 (33)5.2安装包生成的COMFRA.PROPERTIES配置文件不允许跨平台复制 (33)第1章系统启动常见问题1.1 网络连接失败TLQ启动时，网络连接失败，屏幕上输出如下提示信息:TLQ has started!TLQ start failed,please check [TongLink.sys]!!!系统日志文件TongLink.sys中会报如下错误：E 0716 16:32:46.484|4|5988-17a0|sendqcu|NetSndThread.c|2106|54:10060|SockConnect: socket connect failed. HostName=168.1.1.33, port=10004socket网络连接失败，有如下原因分析及解决方案：z有可能目标节点没有启动或者接收进程监听端口号（不是10004）跟发送连接的端口号不一致。
