分界口通信机软件维护手册

文件编号：CASCO_TEM_DEV_006模板版号：1-A分界口通信机软件维护手册版本：0 卡斯柯信号有限公司修订页编号章节名称修订内容简述修订日期修订前版本号修订后版本号修订人批准人1创建全文2007-1-26V0.0.1段学群2修改配置说明2007-6-4V0.0.2吴建松目录TOC\o"1-3"\h\z1. 引言 21.1. 编写目的 21.2. 项目背景 21.3. 定义 21.4. 参考资料 22. 系统说明 22.1. 系统用途 22.2. 安全保密 22.3. 总体说明 32.4. 程序说明 33. 操作环境 43.1. 设备 43.2. 支持软件 43.3. 数据库 44. 维护过程 54.1. MQ通道的维护 54.2. 配置文件的维护 84.2.1. layout_data：站场数据的维护 84.2.2. section_data:区段描述文件的维护 84.2.3. region.cfg配置文件的维护 84.2.4. CONFIG.DEF配置文件的维护 94.2.5. 其它配置文件的维护 11引言编写目的给维护分界口通信机的工程人员或软件人员使用。项目背景铁道部日前发布了418号文（简称互连互通协议），规定了TDCS系统间的交互信息的规程。部中心与路局，路局之间，路局与车站之间均需按此规程通信，以便于系统间的互连互通。开发单位是卡斯柯信号有限公司，安装在各个铁路局的TDCS机房，名称为：TDCS互联互通分界口通信机软件。定义TDCS：TrainDispatchingCommandSystem列车调度指挥系统GPC：graphicprocesscontrol调度台人机交互软件参考资料参考资料如下：序号参考资料名称（标题）及版本号作者批准或出版社发布时间备注1列车调度指挥系统(TDCS)数据通信规程(V2.0)铁道部运输局2005.11.22系统说明系统用途分界口通信机用于实现路局与路局之间的通信，输入是邻局发送过来的表示信息，到发点信息，运行图信息，调度命令信息，限速命令信息，输出是本局提供给邻局的相同信息。安全保密本系统只是在路局和路局之间传输信息。路局之间的通道是独立的，路由器是专用的。总体说明分界口通信机用于实现路局之间的通信，传递的消息主要有控制信息、通信状态信息、表示信息、到发点信息、运行图信息、调度命令等信息。其系统结构图示如下： 程序说明分界口通信机采用单一进程下的多线程方式，由主任务main_task（进程）和各子任务bl_comm_task、fjk_realtime_comm_task、fjk_non_realtime_comm_task、realtime_task、non_realtime_task、sys_print_task以及人机界面组成。结构图示如下：各模块说明如下：1.bl_comm_task，该任务采用多线程方式，负责与BL或CT通信机通信，将从BL或CT通信机获得的信息转发至realtime_msg_task的消息队列中，并将QUEUES.BL＊.COMM中的消息发送至服务器。此处将支持与多个BL的连接。2.fjk_realtime_comm_task，负责处理与实时MQ通道相关的内容，将从实时MQ通道中取得的信息根据内容分发到realtime_msg_task的消息队列中，将消息队列QUEUES.FJKREALTIME＊.COMM中的内容发送至分界口。此处将支持与多个分界口的连接。3.fjk_non_realtime_comm_task，负责处理与非实时MQ通道相关的内容，将从非实时MQ通道中取得的信息根据内容分发到non_realtime_msg_task的消息队列中，将消息队列QUEUES.FJKNONREALTIME＊.COMM中的内容发送至分界口。此处将支持与多个分界口的连接。4.realtime_msg_task，负责处理实时信息，从消息队列QUEUES.REALTIME.MSG中读取bl_comm_task转发过来的信息，处理后将消息分发至fjk_realtime_comm_task的消息队列中；读取fjk_realtime_comm_task转发过来的信息，处理后将消息分发至bl_comm_task的消息队列中。5.non_realtime_msg_task，该任务采用多线程方式，负责处理非实时信息，从消息队列QUEUES.NONREALTIME＊.MSG中读取fjk_non_realtime_comm_task发送来的请求，根据请求从数据库服务器获取信息并进行相应转换，将处理后的信息发送至fjk_non_realtime_comm_task的消息队列中。6.sys_print_task，负责日志信息的打印。7.人机界面，负责界面状态信息的维护。操作环境设备采用IBMX346服务器。CPU：Xeon3.0GHz内存：2网络：10/100/1000M自适应以太网卡*2硬盘类型：SCSI光驱：DVD-ROM支持软件操作系统使用MicrosoftWindowsServer2003,主要开发工具为VisualStudio2005和MQ6.0。数据库该程序会跟数据库服务器中的CASCO和STI数据库建立ODBC连接non_realtime_msg_task模块在运行中会调用CASCO和STI这两个数据库连接，CASCO用于基本图、历史图、实际图、站存车和小编组等信息的查询，STI用于确报信息的查询。维护过程MQ通道的维护当程序运行过程中，MQ有可能会出现一些故障或问题，比如通道不通等等，则需要对其进行维护，检查和维护方法如下：首先，右击屏幕右下角的MQ标志，打开WebSphereMQ资源管理器，如下图：然后，首先查看队列管理器的状态，如果是停止状态（红色向下箭头），则右击该队列管理器，选择启动，如下图所示：在确保队列管理器启动后，查看MQ通道和侦听器的状态，打开队列管理器的扩展目录，选择通道，则可以在右侧的栏目中看到通道的状态，红色向下箭头表示通道停止了，绿色向上箭头表示活动状态。每个邻局分界口有四个MQ通道，两个发送通道和两个接收通道，通道的连接名称是IP地址的是发送通道，否则就是接收通道，右击通道，选择属性，查看通道的连接名称，如下图所示：没有连接名称的就是接收通道，只有发送通道需要启动，接收通道是不需要启动的。右击发送通道名称，选择启动，由此启动通道。如下图所示：最后看一下侦听器是否启动，点击左边栏目中的侦听器，看右边栏目中的侦听器的状态，绿色向上箭头表示已经启动，红色向下箭头表示停止了，一般侦听器会随着队列管理器自动启动，如果没有启动则手动启动一下，如下图所示：配置文件的维护layout_data：站场数据的维护在分界口通信机上，建有一个FTP，给邻局提供相关的配置文件，文件夹的名称是：fjk_ftp_路局代码，各个路局的代码参见铁道部附件1，在该目录下，有一个layout_data的文件夹，该文件夹下包含各调监显示区段目录，各站场文件存放在各自的调监显示区段目录下。layout_data/dispatch_局码+调监显示区段ID(16进制)/，例如哈尔滨局三加台调监显示区段layout_data/dispatch_010001/（哈尔滨局三加台调监显示区段ID为0x0001）。在layout_data/dispatch_010001/目录下存放此调度区段包含的各个站场数据。站场文件的命名：layout路局码(16进制)＋站码(16进制).dat例如：哈尔滨局哈尔滨站layout010001.dat（假定哈尔滨局局码为0x01，哈尔滨站站码为0x0001，各路局统一编码）。以后如果站场数据有变化，则需要在此目录下作相应的更新，用新的数据替换原来的文件，需要注意的是，文件以及文件夹的名称需要按照上述的规则来命名。section_data:区段描述文件的维护在fjk_ftp_路局代码目录下，还有一个文件夹section_data，里面包含了区段描述文件，文件的命名规则是：section路局码(16进制)＋调监显示区段ID(16进制).cfg，例如：哈尔滨局的第一个调度台section010001.cfg（假定第一个调监显示区段ID为0001，各路局统一编码）。类似的，如果以后该数据有变化，也需要在此目录下更新文件，同样要注意文件的命名规则。region.cfg配置文件的维护Region.cfg配置文件是从GPC的配置文件entry.cfg，gpc.def，line.cfg，te.def以及另外由TLE站场数据生成的包含部分车站列表和调监显示区段的文件region.cfg得来的，当GPC的这四个配置文件或者车站列表和调监显示区段信息有所更改的时候，该region.cfg配置文件需要更新。在C:\fjk_run\ConvertTool目录下有一个小工具ConvertTool，可用来自动生成region.cfg配置文件，当需要更新region.cfg配置文件的时候，将最新的GPC的配置文件entry.cfg，gpc.def，line.cfg，te.def以及原来的region.cfg置于该目录下，然后点击ConvertTool.exe应用程序，显示如下图对于单套数据库服务器的路局，是不需要输入站号偏移量的，多套数据库服务器的路局是需要根据不同的服务器来设置偏移量的，目的是让不同服务器的站号统一起来，然后点击运行，就会生成需要的region.cfg文件，同时可能会弹出一些信息缺少或不一致的警告信息，这些信息会纪录在该目录下的A文件里，供查看。对于多套服务器的情况，每套服务器的配置文件运行一次该软件，生成一个region.cfg文件，然后，参照TDCS数据通信规程的附件四(铁路局相关交换文件的规定)，将各套服务器生成的region.cfg文件中的每一项配置进行手工合并，生成一个region.cfg文件。CONFIG.DEF配置文件的维护在C:\fjk_run路径下，有config.def配置文件，对其中的各项配置说明如下：[BLHOSTNAME]blhostname1=CTClient,BLZZServer.cfg,blzz_server, 1, 1/1004, 0, 1/1, 0blhostname2=CTServer,BLZZClient.cfg,blzz_client, 2, 0, 1/92, 0, 1/92配置分界口通信机所需连接的CT通信机或通信前置机。第一项为主机名字，即主界面上相应图标下的文字，第二项为通讯配置文件名称，第三项为连接端口名称，第四项为通信方式，第五项为该主机请求车站列表，第六项为管辖列表，第七项为请求车站转换列表，第八项为管辖车站转换列表。[FJKNAME]fjkname1=上海铁路局分界口,r_sh_nc_mqr,r_nc_sh_mqs,nr_sh_nc_mqr,nr_nc_sh_mqs,15,5, 1/92,1/1004,2/92/1004,2/3420/1511上述信息表示与分界口连接的相应信息，包括通信对方名称,输入队列名称,输出队列名称，对方IP地址，分界口代码以及请求车站列表,管辖车站列表,局间站号转换列表。[MANAGERNAME]managername=NC_MQM上述信息表明队列管理器为NC_MQM。[TITLENAME]titlename=南昌铁路局分界口上述信息用于说明应用程序标题。[BUREAU]bureau=13用于指定路局代码。[SUBBUREAU]subbureau1=1,174/1-58/62-72/75-144/146-180,174/1-58/62-72/75-144/146-180上述信息为分局代码信息，每一分局占用一行。第一项为分局代码，其后为站号转换列表，表示收到的站号及转换后发送给铁道部的站号。一般应将收到的站号去掉偏移量，还原为原始站号。[SUBBUREAUEXT1]subbureauext11=1, 15/1-7/52/54/56/57/100-102/107subbureauext12=2, 18/8-18/45-51subbureauext13=3, 14/19-29/53/55/58subbureauext14=4, 11/30-40subbureauext15=5, 19/41-44/62/63/108-120subbureauext16=6, 9/121-129subbureauext17=7, 9/64-72subbureauext18=8, 25/75-99subbureauext19=9, 19/103-106/130-144subbureauext110=10, 35/146-180上述信息表示济南铁路局调度区段信息。该信息来于region.cfg配置文件。[GPCLOCATION]gpclocation1=1,6/1/3/4/6/7/18上述信息表示调度台与数据库服务器的分配关系，尤其是用于多套服务器的情况。[DISPATCHINFO]dispatchinfo1=1,1, administrator, 1, d$\gpc\data\DDMLdispatchinfo2=2,2, administrator, 2, d$\gpc\data\DDML上述信息表示调度区段号与IP地址、登陆该电脑的用户名、密码及调度命令共享目录之间的关系，等号之后的信息依次表示：调度区段号,IP,用户名,密码,共享目录，在TD结合程序的配置文件SysConfin.ini文件里，也有该配置信息。[OFFSETTIME]offsettime=1800上述信息表示如果接收到的请求信息中带的时间与当前机器的时间的偏差超过这个数目的时候（单位为秒），则丢弃该请求消息包，该配置项为可选。[ODBC]odbc1=casco1, db2, db20,1odbc2=casco2, db2, db20,2odbc3=casco3, db2, db20,1odbc4=casco4, db2, db20,2上述信息表示应用服务器的配置信息，等号之后的信息依次表示：数据库名称，用户标示，密码，应用服务器地址。[STATIONCONVERTLIST]stationconvertlist1=1,206/1-180/201-208/501/521-527/530-534/10