基于MQ的统一传输平台用户手册.doc

基于MQ的统一传输平台软件用户手册基于MQ的统一传输平台软件用户手册1.0.00版铁道部信息技术中心二00三年三月目 录一 系统简介31.1前言31.2系统特点31.3系统功能31.3.1应用传输接口（Application Transmission Interface）31.3.2应用传输服务程序41.3运行环境要求41.4约定51.5注意5二 安装与启动52.1 准备工作52.2 安装过程52.2.1 UNIX系统52.2.2 Windows系统62.3安装后软件的目录结构及用途112.3.1 Unix系统112.3.2 Windows系统122.3.3 日志文件132.3.4 参数文件132.3.5 初始化文件142.4参数文件及初始化文件的配置142.4.1参数文件的格式说明142.4.2参数文件的内容说明142.4.3 初始化文件的格式及内容说明152.5MQ的配置202.5.1 本地队列202.5.2 远程队列（发送队列）202.5.3通道的命名202.6软件的启动和停止212.6.1 Unix系统212.6.2 Windows系统22三 维护与管理28四 标准应用传输通信接口程序的使用304.1 介绍304.2 标准函数接口314.2.1 ATISEND314.2.2 ATISEND1344.2.3 ATIRCV344.2.4 ATIRCV1374.3 使用方法384.3.1 使用C语言源代码384.3.2 使用动态连接库(C语言)424.3.3 WINDOWS系统下使用动态连接库(VB 6.0)444.4 参数文件44附录一44附录二50附录三51一 系统简介1.1 前言 TMIS信息系统建设初期设计的通信方式是以建立集中式中央实时数据库体系结构为基础的。铁路分局乃至基层站段所有TMIS信息系统的信息端点（报告点、查询点）均直接连接X.25通信网，和TMIS中央系统进行信息传输。根据新调整的TMIS总体方案，确定在部、路局和分局建立三级货票库、确报库、自动车号识别信息库和动态车辆库，致使应用系统的数据流向发生重大变化。站段原始信息不但要上报铁道部，还要在分局、路局落地入库。应用方式的变化要求TMIS通信方案必须进行必要的调整。TMIS建设初期，应用项目的开发基本上是纵向进行的，实施时自下而上或自上而下，从车站到分局、路局或部中心。每个应用项目采用的通信方式各不相同，有的甚至使用不同的通信服务器。因此，为了适应新调整的TMIS总体方案，铁道部信息技术中心及领导提出了必须建立统一的TMIS传输平台，为各应用的数据传输提供高质量、高可靠的服务的战略方针。 本项目的任务提出、组织、开发者为铁道部信息技术中心。该项目的用户为TMIS各应用开发组及部中心、全路各路局、分局、TMIS信息报告站等。统一TMIS传输平台软件涉及应用传输服务、应用传输接口、MQ传输监控及日志统计等几大模块。各模块之间既有联系，也相对独立。 1.2 系统特点（1）兼容性：TMIS的各应用系统离不开数据传输，由于TMIS有的应用项目已经投产运行，在运输生产当中发挥着重要的作用，有的正处于建设、实施的过程中，因此本系统在设计过程中，充分考虑了上述的因素，尽可能地做到新旧兼容，使已经投产的应用少做改动。（2）可操作性：应用系统在全路的实施过程中不可能做到一夜之间全部完成，需要有一定的时间周期；有些已投产的应用系统的数据传输模式在向新的统一传输平台转换时，也需要有一个转换的过程。因此本系统在设计过程中，充分考虑了上述的因素，力求做到在实施中的可操作性。（3）较强的适应性：TMIS各应用系统的特点不同，其数据传输的模式也不尽相同，有三级落地转发模式，有点到点的传输模式，还有跨节点的传输模式等，本系统能够适应上述的各种模式。（4） 有较强的容错能力，保证了系统的高可靠性。1.3 系统功能1.3.1应用传输接口（Application Transmission Interface）统一TMIS数据传输格式；为应用屏蔽MQ，尽可能地简化用户在数据传输过程中的调用接口，做到用户只需填写做什么、从哪发、发到哪、怎么发既可；通过对要传输数据源地址和目的地址的填写，为实现TMIS数据自动转发和分发打下了基础；该软件支持消息到消息的传输，结合不同应用对接收消息的处理入库模块后，即完成了TMIS数据库到库的传输；除此之外，该软件还支持文件到文件的传输、消息到文件的传输、文件到消息的传输等。对于较大的文件，该软件还支持大文件分段传输；与应用传输服务程序相结合，实现多地址分发的功能；若遇到队列满、队列不可用、队列正在用等临时错误情况时，会自动RETRY； 支持MQ SERVER和MQ CLIENT两种方式； 为应用提供源程序、动态连接库等调用方式。此接口可以提供给新上的TMIS应用或改为用MQ传输TMIS数据的应用使用。当应用程序有数据要发送或接收时，调用此接口。能够运行在AIX、SCO UNIX、WINDOW S等平台上。1.3.2应用传输服务程序 三级应用传输服务程序将运行在分局、路局、部中心三级的MQ通信服务器上，是常驻进程。负责对消息进行上传、下发、落地等处理； 可按下述转发规则进行转发：同分局车站由分局转发；跨分局的信息由本路局转发；跨路局的信息由铁道部转发； 同时支持点到点及跨节点传输模式；按应用需求灵活处理信息是否落地问题；支持多地址转发； 1.3.3 MQ消息传输日志 将通过MQ接收通道传输过来的消息的相关信息，如：消息的目的地址、消息的发送者和发送时间等信息记录下来，定时打包发送到部中心，入库，并通过页面查询。 1.3 运行环境要求(1) 应用传输接口程序硬件环境：能够运行在小型机、PC机等硬件环境上。软件环境：适用于UNIX、WINDOWS等平台，需安装MQ SERVER 或MQ CLIENT软件。(2) 应用传输服务程序：硬件环境：将运行在全路通信服务器（RS/6000、NetFinity5000）上。软件环境：AIX、WINDOWS NT SERVER 4.0 企业版、WINDOWS 2000，需安装MQ SERVER。推荐使用WINDOWS 2000+SP2+MQ V5.2+CSD04，也可用WINDOWS NT SERVER 4.0企业版+SP6A +MQ V5.1+CSD07。注意：对于NT SERVER 4.0 企业版，还要在系统环境变量中加上一条：TMQ_DEFAULT_MODEL=FIXEDRS/6000平台推荐使用AIX 4.3+MQ V5.1+CSD07 或AIX 4.3 + MQ V5.2 + CSD04。(3) MQ 消息传输日志分别运行在WINDOWS、UNIX平台上，需有MQ SERVER或MQ CLIENT、部中心需有数据库软件。1.4 约定调用应用传输接口时：(1) 源地址和目的地址的填写应该是全地址名。既某路局某分局某车站。采用TMIS标准站名代码。这里指出的目的地址，应该是这份数据要传输的目的地址。(2) 消息传输的最大消息长度为4M。(3) 进行文件传输时，目的文件的文件名长度不能超过15字节。应用传输服务程序：(1) 对消息进行多地址分发时，目前一次最多支持24个地址。MQ 消息传输日志：(1) 若启用通道出口程序msglog.dll 记录日志，则必须以定时启动的方式运行putlogtoq.exe程序传输日志，以免本地盘被占满。1.5 注意本系统的安装和使用者需要对WINDOWS、UNIX操作系统、MQ软件等有一定的了解。 二 安装与启动2.1 准备工作安装前保证操作系统运行正常、MQ软件安装完毕且运行正常。双机环境或单机环境下，放置atserver数据文件的共享盘或内置盘有足够的空间，最好大于等于120M。2.2 安装过程2.2.1 UNIX系统安装软件分为两个tar格式的文件包， atserver.tar和atserver.data.tar。atserver.tar中包含的主要是可执行程序，其中的文件需放在本地内置盘上。atserver.data.tar中包含的主要是参数文件等，其中的文件最好放在共享盘上。(1) 进入超级用户“root”，在“mqm”用户的根目录（如/home/mqm）下运行：tar xvf atserver.tar解压缩，自动生成atserver目录，该目录下有可执行程序atsvr、atdfh、zmzdrcv、atmon、putlogtoq；库文件msglog和脚本文件startmon、stopmon、crontab.cro、rmmail，在/etc目录下生成INI文件ATIFILE.INI、PUTLOGTOQ.INI。(2) 在/etc下执行命令：chown R mqm：mqm ATIFILE.INIchown R mqm：mqm PUTLOGTOQ.INIchmod 777 ATIFILE.INIchmod 777 PUTLOGTOQ.INI修改文件的用户属性等。(3) 在共享盘上建立大于120M的文件系统，一般情况下可以使用安装MQ系统时所建的/mqfs1，若现有空间不大，最好再扩120M。(4) 然后在共享盘的文件系统的根目录下运行：tar xvf atserver.data.tar进行解压缩，自动生成atserver一级目录和atproc二级子目录。 atserver目录下有参数文件ruler、sta_dict.cfg、virtnode.cfg，atproc子目录下有参数文件applstat.cfg、mynode.cfg、queue.cfg。2.2.2 Windows系统 安装程序名为setup.exe。运行setup.exe出现准备界面：然后出现欢迎界面：点击Next进入注册界面：填写好 User Name 和 Company Name 后，点击Next进入选择软件安装路径界面：此界面显示的Destination Folder，可以选择和修改，它是指存放参数文件和日志等数据文件的目录，应选择放在共享盘上的atserver子目录下，包括参数文件ruler、sta_dict.cfg、virtnode.cfg，自动生成的子目录atproc和此目录下的applstat.cfg、mynode.cfg、queue.cfg三个参数文件。（可执行程序不受此限制，它们将自动被放在系统盘的atserver目录下，包括atsvr.exe、atdfh.exe、msglog.dll、putlogtoq.exe、zmzdrcv.exe五个文件。参数文件ATIFILE.INI和PUTLOGTOQ.INI自动放在系统windows目录下，如C：WINNT，库文件AMQATI.DLL、AMQATIC.DLL、AMQATIC.DLL.W9X自动放在windows的system目录下，如：C：WINNTSYSTEM32。）点击Browse进入修改安装目录界面：将安装目录设为“共享盘符：atserver”，点击确定键，返回选择软件安装路径界面，再点击Next进入软件安装界面：点击Next开始软件安装，到完成界面：点击Finish完成软件安装过程。2.3 安装后软件的目录结构及用途无论使用哪种通信服务器，软件安装完成后，分为两部分，可执行程序将放在本地硬盘上，参数文件等将放在共享盘上。2.3.1 Unix系统假设本地硬盘上“mqm”用户的根目录为“/home/mqm”，共享盘的根目录为“/mqfs1”，则安装及运行后产生的目录结构如下：/home/mqm/atserver/atsvr |atdfh |zmzdrcv |atmon |putlogtoq |msglog |startmon |stopmon |crontab.cro |rmmail/etc/ATIFILE.INI（大写） |PUTLOGTOQ.INI（大写）/mqfs1/atserver/ sta_dict.cfg | virtnode.cfg | ruler | atproc/ applstat.cfg| mynode.cfg| queue.cfg | tail_id| head_id| deadfile/| lostfile/| log/atwork*.log|errmsg*.log|dfwork*.log内置盘上文件的用途说明：atsvr 应用消息传输处理程序。atdfh 死信文件处理程序。zmzdrcv 自动更新参数文件如:站名字典文件的程序。atmon 监控atsvr 和atdfh的程序，atsvr 和atdfh进程如果中断，该程序会自动重新将它们启动起来。msglog MQ接收通道消息出口程序。应加在MQ消息通道接收端的消息出口处，获取经过接收通道的消息的相关信息，并记录在日志文件中。putlogtoq 发送日志文件程序，将msglog记录的日志文件发送到指定队列中。与msglog相配合，两者必须同时使用或不用。startmon 启动atsvr和atdfh程序的脚本文件。stopmon 停止运行atsvr和atdfh程序的脚本文件。crontab.cro 定时启动putlogtoq程序的脚本文件。2.3.2 Windows系统设本地硬盘上操作系统所在的盘符为“C：”，共享盘的盘符为“D：”，则安装及运行后产生的目录结构如下：C:atserveratsvr.exe |atdfh.exe |zmzdrcv.exe |putlogtoq.exe |msglog.dllC:WINNTATIFILE.INI |PUTLOGTOQ.INIC:WINNTSYSTEM32 amqati.dll | amqatic.dll | amqatic.dll.w9xD:atserver sta_dict.cfg | virtnode.cfg | ruler | atproc applstat.cfg| mynode.cfg| queue.cfg | tail_id| head_id| deadfile| lostfile| logatwork*.log|errmsg*.log|dfwork*.log内置盘上文件的用途及说明：atsvr.exe 应用消息传输处理服务程序。atdfh.exe 死信文件处理服务程序。zmzdrcv.exe 自动更新参数文件如:站名字典文件的程序。msglog.dll MQ接收通道消息出口程序。应加在MQ消息通道接收端的消息出口处，获取经过接收通道的消息的相关信息，并记录在日志文件中。putlogtoq.exe 发送日志文件程序，将msglog记录的日志文件发送到指定队列中。与msglog相配合，必须同时使用或不用。2.3.3 日志文件无论使用哪种平台，传输服务程序运行时，在共享盘的atserveratproc目录下会自动生成一些工作用的文件和日志文件等。如：tail_id、head_id文件；deadfile、lostfile、log子目录。在log子目录下生成atwork*.log、errmsg*.log、dfwork*.log日志文件。“*”表示序号。tail_id atsvr、atdfh程序使用。head_id atsvr、atdfh程序使用。deadfile 存放死信文件的目录。lostfile 存放垃圾文件的目录。log 日志文件目录。atwork*.log 记录atsvr程序运行情况的日志文件。dfwork*.log 记录atdfh程序运行情况的日志文件。errmsg*.log atsvr处理消息产生错误时，记录消息的相关信息的日志文件。2.3.4 参数文件无论使用哪种平台，传输服务程序运行之前，都要事先在共享盘的atserver和atserveratproc目录下设置好参数文件。各参数文件的用途如下：sta_dict.cfg 站名字典文件virtnode.cfg 虚拟分局（无分局的路局）代码文件。ruler 为运行MQ系统提供的runmqdlq程序，所做的配置文件。applstat.cfg 应用状态配置文件。mynode.cfg 本节点信息文件。queue.cfg 传输服务程序atsvr看护的队列名文件。2.3.5 初始化文件通信服务器上的zmzdrcv或zmzdrcv.exe程序需要使用ATIFILE.INI文件。putlogtoq或putlogtoq.exe、msglog或msglog.dll程序使用PUTLOGTOQ.INI文件。软件包安装完成后，应对这两个初始化文件进行配置。2.4 参数文件及初始化文件的配置软件安装完后，紧接着应按本地的实际情况，做上述各参数文件的配置及修改。atsvr程序需要sta_dict.cfg、virtnode.cfg、applstat.cfg、mynode.cfg、queue.cfg五个参数文件，atdfh程序与atsvr程序共用mynode.cfg参数文件。特别注意：启动atsvr和atdfh之前，要对mynode.cfg 、applstat.cfg、queue.cfg这三个参数文件进行修改和确认。2.4.1参数文件的格式说明 参数文件的每一行代表一条记录。参数文件中“#”和“！”字符有专门的用途，只在每行的第一个字母时有效，“#”符表示该行为注释行；“！”符表示参数文件结束，“！”符后面的字符不起作用。2.4.2参数文件的内容说明sta_dict.cfg 站名字典文件，内容是电报码和TMIS码对照表，该参数文件不需要用户自己配制，由zmzdrcv程序自动更新。virtnode.cfg虚拟分局TMIS码(表示无分局的路局的一个虚拟分局码,在TMIS基础数据字典中有定义)配置文件，每行代表一个虚拟分局TMIS码，需要填写所有的虚拟分局码。applstat.cfg 应用状态配置文件，每个TMIS应用有一行记录，以集装箱应用为例，其记录格式为：“JZX 1 1 APPLJZXQ RJZX”，每个字段的含义如下：JZX：应用标识码，每个应用一个，如：确报应用：“YT-1”货票应用：“HP ”车号识别：“ATIS”调度系统：“DDXT”集装箱： “JZX ”分局货调：“FJHD”三级转发（车站车辆报告）：“SJZF”通信系统专用站名字典更新：“MQZM”1： 本地应用状态，“0”表示本地应用为旧版本，即仍由应用负责消息的转发，atsvr程序不负责转发；“1”表示本地应用为新版本，由atsvr程序负责转发应用消息。1： 应用消息在本地是否落地入库，“0”表示本地应用不需要消息，此时atsvr程序不会将消息放入应用队列；“1”表示本地应用需要消息，atsvr程序自动将消息放入应用队列；APPLJZXQ：是本地应用接收消息队列名；RJZX：atsvr程序转发消息时使用的远程队列名的前缀。mynode.cfg 本节点信息文件，用于描述本节点的一些信息，此配置文件中只能有一行配置信息。以哈尔滨分局为例，其格式为： “01 2 QM01”。01：本地路局或分局的TMIS码。分局为TMIS两位数字码，路局为TMIS一位字母码，如哈尔滨路局“B”。2： 本地级别说明，共分4级：“4”代表铁道部、“3”代表路局、“2”代表分局、“1”代表车站；QM01：本地MQ通信服务器的队列管理者名，必须大写。queue.cfg atsvr程序需要看护的队列名配置文件，每行写一个队列名。ruler 为运行MQ系统提供的runmqdlq程序，所做的配置文件，内容如下：REASON(MQRC_Q_FULL) ACTION(RETRY) RETRY(5) REASON(MQRC_PUT_INHIBITED) ACTION(RETRY) RETRY(5)含意为：对因本地队列满或本地队列禁止输出这两中原因而导致的消息被放在死信队列中的情况，runmqdlq程序将按一定的时间间隔，试着将此消息从死信队列中取出，重新放回目的队列中。用户还可以根据实际情况，按此格式对内容进行增减。2.4.3 初始化文件的格式及内容说明(1) PUTLOGTOQ.INI日志程序参数文件，运行putlogtoq.exe和msglog.dll程序之前必须配好此参数文件。共有四行参数, 每行不能超过80个字节。第一行是存放日志文件的路径，应事先建好，注意路径不能以或/结尾,注意修改盘符；第二行是本地队列管理者名，应修改此行，注意大写；第三行是发送日志文件的远程队列名；第四行是打包时最大文件数（目前该参数不起作用）。(2) ATIFILE.INI 应用传输接口程序的参数文件。参数文件为标准的INI文件，其中以半角(西文)分号;作为注释，每行的开始和结束的空格、TAB、回车换行等都会被自动过滤。理论上，文件中的空行可以有任意多个。参数文件中不同的应用可以设置自己的配置信息，放到不同的区段中，同时有一个默认的配置，存放公共配置信息。在开发新的应用时，应为新的应用建立集自己的区段。当默认配置中的参数与应用区段中的配置相互冲突时，以应用区段中的配置为准。应用区段中未指明的参数配置取默认区段中的参数配置。DEFAULT SETQMNAME=OS=WINNTATIVersion=1retryCount=0MAX_FILE_BLOCK_SIZE=50506; if WaitInterval = -1, ATIRCV will always wait. (ms)WaitInterval=15000ATI_SEND_RETRY_TIMES=5SHARED_MESSAGE=0JZXRQNAME=QLQNAME=Q1REPLYTOQNAME=testATIVersion=1OS=WIN2KLOCALADDRESS=P0199947区段名称包含在“”和“”之中，和参数的定义区分出来。如上例中的默认区段“DEFAULT SET”，集装箱区段“JZX”。参数的设置格式为:参数名=参数值，参数的值不要加引号，从等于号到行结束或注释符号之前的部分都是属于参数的设置(参数值)。参数文件中的某一行中只有参数名或参数名+“=”的方式，如：“OS=”或“OS”都表示将此参数设置为空，如果取消某一个参数的取值，可以采用注释的方式。参数的名称必须在32个字符以内，参数文件的每行长度不能超过255个字符，所以参数的名称和参数值的总长度应在255个字符以内，否则超出的部分将被截除。所有配置参数的名称大小写无关，参数：ATI_SEND_RETRY_TIMES与ATI_Send_Retry_Times是指同一个参数，但参数的设置值的大小写是否有关由应用程序自己定义。主要参数的名称及其参数值的含义如下：ATI_SEND_RETRY_TIMES：在通信程序发送消息时，由于系统资源，环境等原因会使发送不成功，ATISEND可以自动重新发送消息，重试的次数由此参数指定。ATI_SEND_RETRY_TIMES=0或没有此参数的设置，在发送不成功后，发送函数将不重新发送，直接将第一次发送的结果(返回码和MQ错误码)返回到用户的程序中。ATI_SEND_RETRY_TIMES的设置值大于零时，表明发送要重新发送的次数。RQNAME： 消息要发送到的队列名，即发送函数要PUT的队列名称。可以是本地队列，也可以是远程队列的本地定义(QREMOTE)、队列别名(QALIAS)、本地队列(QLOCAL)。由于在MQ中，队列的名称字母大小写是区分的，所以RQNAME的参数值需要写出大小正确的队列名称。LQNAME： 本地队列名，是接收函数要读取消息的队列名，ATIRCV和ATIRCV1从LQNAME所指定的队列中都取消息。同RQNAME，LQNAME的参数值也是大小写区分的。REPLYTOQNAME： 发送消息时，如果需要应用程序可以指明消息的返回队列。QMNAME： 当前队列管理器的名称。请注意区分设置值的大小写。用“QMNAME=”表示当前系统中默认的队列管理器。ATIVersion： 设置采用ATI接收和发送的版本。目前支持两个版本：ATIVersion=0和ATIVersion=1。ATIVersion=0是为了和以前的版本兼容，这种情况下发送的数据和未采用此通信接口的格式是完全一致的。ATIVersion=1表示发送到队列的数据已经改变为新的格式。OS：指明当前操作系统的类型，参考取值有：WIN95、WIN98、WINNT、WIN2K、WINXP、UNIX等。LOCALADDRESS：本地的通信地址。第一字节表示局码，第二三字节表示分局码，第四到八字节表示车站TMIS码。具体请参考本文4.2.1节的ATISEND的参数说明中关于Destation参数的描述。RetryCount：与ATISEND的发送出错重试无关。此参数为系统保留参数，请保持RetryCount=0或将此参数注释。WaitInterval：设置接收函数以等待的方式接收数据时，要等待的时间。本参数以毫秒作为单位，WaitInterval=15000表明要等待15000毫秒，即15秒。WaitInterval=-1表示以无限期的方式等待。MAX_FILE_BLOCK_SIZE：在传输文件时，考虑到文件可能会比较大，为了提高MQ传输的效率，将文件分割成多个消息进行分别传送。无论要传送的文件是多大，最多只能分割成99块。分割的块数越多，对MQ的性能要求越高，在测试时(WIN2K)，以分割不超过20块的消息传送为最佳。例如，当要传送最大可达5M的文件时，传输块最小为5000000/99即50506字节，最佳传输大小为：5000000/20=250000，约250K字节。如果有多个地址要分别发送，还需要加大此参数的设置值。加大此参数设置值在传输小文件时，不会造成传输信道明显的浪费。SHARED_MESSAGE：发送程序时，如果要接收的目标地址有多个，可以采用至少以下两种方式进行发送：l SHARED_MESSAGE=0：每个目的地址都发送一份消息，每一条消息中只记载一个目的地址。l SHARED_MESSAGE=2：本次发送只发送一份消息，每一条消息中记录了所有的消息地址。通信服务程序自动根据目的地址判断接收队列，进行转发。Dest_Addr_Plugin Dest_Addr_Plugin_LIB_NAMEDest_Addr_Plugin_FUNCTION_NAME以上三个参数为系统保留，请保持参数被注释或 Dest_Addr_Plugin=N。SYNCPOINT采用同步方式(默认，SYNCPOINT=1)发送大文件时，ATISEND将文件分割成多个文件块(不超过99个)，如果MQ日志文件较小但文件的块数较多或文件块的大小较大都会引起发送失败，用户可设置“SYNCPOINT=0”来取消不同文件块的同步发送方式，但这样有可能会使发送的文件不完整。如果在随后的对该文件的重试发送中成功发送了，在此之前对该文件的发送失败可以忽略。MQSERVER_VERSION在MQ的客户端是5.0或以上版本，并且MQ服务器的版本低于5.0时，设置“MQSERVER_VERSION=2”，否则不设此值或设置为“MQSERVER_VERSION=5”。由于zmzdrcv程序需要用到此参数文件，因此在通信服务器上的软件安装好后，应对此参数文件的MQZM区段进行修改，填上“QMNAME=”参数，为本地队列管理器名。MQZMRQNAME=QMNAME=LQNAME=APPLMQZMQREPLYTOQNAME=ATIVersion=1OS=WIN2KLOCALADDRESS=retryCount=5; if MQWaitInterval = -1, ATIRCV will always wait. (ms)WaitInterval=15000MAX_FILE_BLOCK_SIZE=20480;Dest_Addr_Plugin=Y ;Dest_Addr_Plugin_LIB_NAME=;Dest_Addr_Plugin_FUNCTION_NAME=SHARED_MESSAGE=2;SYNCPOINT=0;MQSERVER_VERSION=2ISPSATI=12.5 MQ的配置为了能使atsvr、putlogtoq、zmzdrcv等程序能正常工作，必须对MQ的通道、队列、进程等进行正确的配置。2.5.1 本地队列 通信服务器上的本地队列大致分为两类：一类为atsvr程序守护的队列，即atsvr程序从该队列中接收消息。对于使用统一传输平台传输数据的每一个应用系统，在各级的通信服务器上都要为它们定义一个这样的队列，其命名规则为：以“CS”作为前缀，其后为应用标识码，如：“CSJZXQ”。所有在参数文件queue.cfg中指出的队列，都应事先用MQ命令定义好。第二类本地队列为各应用系统守护的队列，即每个应用系统从各自相应的队列中接收消息，做落地入库等处理。在各级的通信服务器上都要为它们定义一个这样的队列，其命名规则为：以“APPL”作为前缀，其后为应用标识码，如：“APPLJZXQ”。所有在参数文件applstat.cfg中指出的应用队列，都应事先用MQ命令定义好。对于已经使用MQ传输的应用系统，在切换到统一传输平台上时，针对各自的情况，修改应用参数，使应用程序改从APPL*Q队列中接收消息，将原先应用使用的队列通过别名指向CS*Q。除此之外，还要为zmzdrcv的启动定义一个“APPLINITQ”。 2.5.2 远程队列（发送队列）在各级的通信服务器上，还要为每个应用系统定义一套到相邻节点的远程队列，用于消息的转发。其命名规则为：以R+标识应用码作为前缀，其后为单位代码，R+标识应用的前缀+单位代码，如：“RJZX24”表示到集装箱应用北京分局的发送队列。所有在参数文件applstat.cfg中指出的发送队列，都应事先用MQ命令定义好。对于已经使用MQ传输的应用系统，在切换到统一传输平台上时，针对各自的情况，将原先应用使用的远程队列（发送队列）通过别名指定。除此之外，若要使用putlogtoq，则还要定义发送队列“TO.LOGQ”，将日志文件发送到铁道部。2.5.3通道的命名通道的命名仍以两端的QM为主要标识，当两台MQ SERVER之间同一方向上要建立多于一条通道供不同的应用传输数据时，可以加上应用标识码以示区别。例如：若货票应用使用MQ传输，则最好单独再定义一对通道。MQ配置文件例子参见附录一。2.6 软件的启动和停止2.6.1 Unix系统(1) atsvr程序和atdfh程序由脚本文件startmon启动，其命令格式是：nohup atmon ./atsvr /mqfs1/atserver/atproc &nohup atmon ./atdfh /mqfs1/atserver/atproc &nohup Unix系统命令，制定其后要运行的程序，在启动程序的用户或终端关闭的情况下，不被系统挂起或退出。atmon 管理应用程序进程的程序，由nohup命令制定不被系统挂起或退出。./atsvr atmon程序的第一个参数，被atmon程序监管的程序名，atsvr由atmon程序启动，需要写明该程序对于atmon程序的相对路径或绝对路径。./atdfh atmon程序的第一个参数，被atmon程序监管的程序名，atdfh由atmon程序启动，需要写明该程序对于atmon程序的相对路径或绝对路径。/mqfs1/atserver/atproc atmon程序的第二个参数，表明atsvr和atdfh程序需要的参数文件的路径，这里指的是共享盘上参数文件的绝对路径名。(2) atsvr和atdfh程序由脚本文件stopmon停止，其命令格式是：nohup atmon stop /mqfs1/atserver/atproc &stop atmon程序的第一个参数，停止atmon程序、atsvr程序和atdfh程序。其它说明与上面相同。(3) msglog 或msglog.dll动态连接库通过加在接收通道消息出口处的方法自动执行，将消息的相关信息记录到日志文件中。(4) 上述日志文件的发送程序putlogtoq是通过crontab命令定时启动的。要使用用户“mqm”，执行命令：crontab /home/mqm/atserver/crontab.cro。(5) zmzdrcv程序将通过MQ的配置自动触发起来。前提条件是：MQ配置正确，并且启动MQ触发监视器： runmqtrm q APPLINITQ(6) MQ系统提供了死信队列处理程序，可以按用户提供的规则处理死信队列中的消息，试着将它们重新放到目的队列中。当发现死信队列中有消息时，可输入如下命令：runmqdlq ruler2.6.2 Windows系统(1) 假设参数文件放在盘符为“d：”的共享盘上的atserveratproc路径下，则输入下列命令，将atsvr.exe和atdfh.exe程序加入到服务中：atsvr.exe install atsvr d:atserveratproc 安装atsvr服务atdfh.exe install atdfh d:atserveratproc 安装atdfh服务其中：atsvr.exe 程序名。atdfh.exe 程序名。install 加入服务的命令参数，注意只能以小写字母书写。atsvr 服务名。atdfh 服务名。d:atserveratproc 共享盘上参数文件的绝对路径名。除此之外，相关的命令还有：atsvr.exe remove atsvr 撤消atsvr服务atsvr.exe start atsvr d:atserveratproc 以命令的方式启动atsvr服务atsvr.exe stop atsvr d:atserveratproc 以命令的方式停止atsvr服务当服务安装好后，即可通过服务界面对程序进行启动和停止的操作，并通过设置启动方式为“自动”，无需人工干预，当系统启动后，程序自动启动。(2) 与unix相同，msglog 或msglog.dll动态连接库通过加在接收通道消息出口处的方法自动执行，将消息的相关信息记录到日志文件中。(3) 上述日志文件的发送程序putlogtoq.exe，通过将其加到任务计划中的方式定时自动启动。以windows2000为例，添加过程如下：打开添加计划任务，启动任务计划向导：点击“下一步”，点击“浏览”，选择文件putlogtoq.exe点击“打开”，选择每天执行任务，点击“下一步”，制定好起始时间和起始日期后，点击“下一步”，输入完用户名和密码，点击“下一步”，选择“在单击“完成”时，打开此任务的高级属性（A）”，点击“完成”。在高级属性中选择“日程安排”，点击“高级”，选择“重复任务”，定制每1小时执行一次、持续时间是24小时，点击“确定”，返回“日程安排”界面，点击“确定”完成任务计划的配置。此后，该程序将每隔一小时自动执行一次，将PUTLOGTOQ.INI文件中指定目录下的日志文件打包，发送到TO.LOGQ队列中。对于Windows NT 4.0企业版 ，添加过程如下：打开“My Computer”点击“Scheduled Tasks”打开“Add Scheduled Task”后续的步骤与前述Windows 2000 上的步骤一样。(4) zmzdrcv程序将通过MQ的配置自动触发起来。要求启动MQ出发监视器: runmqtrm q APPLINITQ(5) MQ系统提供了死信队列处理程序，可以按用户提供的规则处理死信队列中的消息，试着将它们重新放到目的队列中。当发现死信队列中有消息时，可输入如下命令：runmqdlq ruler 建议：实施时，可以分两步进行，日志文件部分即msglog(msglog.dll)和putlogtoq(putlogtoq.dll)程序可待系统运行一段时间较稳定后再上。三 维护与管理(1) atsvr 和atdfh在unix平台上启动后，两进程由atmon来监控，一旦发现进程不在，会自动再将它们启动起来。(2) atsvr 和atdfh在WINDOWS平台上作为服务，当系统启动、MQ启动后会自动启动。(3) atsvr 和atdfh的运行情况可以通过各自的工作日志文件atserveratproclogatwork*.log和atserveratproclogdfwork*.log来查看，如：程序的启动、停止，由于各种原因导致对MQ或文件操作失败的错误码等。当MQ管理人员发现传输异常，如：“CS*Q”中消息堆积、“APPL*Q”中没收到消息等，都可通过查看atwork*.log的方式判断问题所在。若发现消息“消失”了，可按下述顺序检查：atdfh是否工作正常，查dfwork*.log；死信队列中是否堆积消息；浏览死信队列中的消息，查消息被放到死信队列中的原因码；按原因码解决问题，如：定义目标队列、清空队列等；按原因码修改ruler；启动runmqdlq程序。 (4) 由于传输服务程序与各应用系统的实施情况等密切相关，因此存在着共享盘上的参数文件如：appstat.cfg经常被修改的可能性，但atsvr程序能够做到允许参数文件动态修改，无需将程序停下来。(5) 在Windows系统中更新软件时，先要删除已安装的程序，运行旧版本setup.exe程序；或在控制面板中运行添加/删除程序，选择atservermor点击“更改/删除”到安装程序的维护界面，选择“Remove”点击“Next”点击“确定”点击“Finish”，完成atservermor程序的删除，再运行新版本的软件安装程序完成更新。四 标准应用传输通信接口程序的使用4.1 介绍标准应用传输通信接口程序是为配合制订统一的通信传输平台而开发的接口程序。在与其它应用程序接口时，标准通信程序提供了至少以下的语言接口：1 标准的C语言发送接收程序(amqati.c, amqati.h, amqati.exp, amqati.lib)2 VB标准模块(amqati.bas、amqati.bas)3 动态连接口的接口(amqati.dll、amqatic.dll)使用标准接口程序时所需要的所有的配置信息都存放