【正文】 |—— tail_id|—— head_id|—— deadfile/|—— lostfile/|—— log/———atwork**.log|——errmsg**.log|——dfwork**.log內(nèi)置盤上文件的用途說明：atsvr —— 應(yīng)用消息傳輸處理程序。）點(diǎn)擊Browse進(jìn)入修改安裝目錄界面：將安裝目錄設(shè)為“共享盤符：\atserver”，點(diǎn)擊確定鍵，返回選擇軟件安裝路徑界面，再點(diǎn)擊Next進(jìn)入軟件安裝界面：點(diǎn)擊Next開始軟件安裝，到完成界面：點(diǎn)擊Finish完成軟件安裝過程。（可執(zhí)行程序不受此限制，它們將自動(dòng)被放在系統(tǒng)盤的atserver目錄下，、。 Windows系統(tǒng) 。(4) 然后在共享盤的文件系統(tǒng)的根目錄下運(yùn)行：tar –xvf 進(jìn)行解壓縮，自動(dòng)生成atserver一級(jí)目錄和atproc二級(jí)子目錄。(2) 在/etc下執(zhí)行命令：chown –R mqm：mqm chown –R mqm：mqm chmod 777 chmod 777 修改文件的用戶屬性等。，其中的文件最好放在共享盤上。 安裝過程 UNIX系統(tǒng)安裝軟件分為兩個(gè)tar格式的文件包， 。 二 安裝與啟動(dòng) 準(zhǔn)備工作安裝前保證操作系統(tǒng)運(yùn)行正常、MQ軟件安裝完畢且運(yùn)行正常。MQ 消息傳輸日志：(1) 若啟用通道出口程序msglog..dll 記錄日志，以免本地盤被占滿。(3) 進(jìn)行文件傳輸時(shí)，目的文件的文件名長度不能超過15字節(jié)。這里指出的目的地址，應(yīng)該是這份數(shù)據(jù)要傳輸?shù)哪康牡刂?。既某路局某分局某車站?3) MQ 消息傳輸日志分別運(yùn)行在WINDOWS、UNIX平臺(tái)上，需有MQ SERVER或MQ CLIENT、部中心需有數(shù)據(jù)庫軟件。推薦使用WINDOWS 2000+SP2+MQ +CSD04，也可用WINDOWS NT SERVER +SP6A +MQ +CSD07。(2) 應(yīng)用傳輸服務(wù)程序：硬件環(huán)境：將運(yùn)行在全路通信服務(wù)器（RS/6000、NetFinity5000）上。 運(yùn)行環(huán)境要求(1) 應(yīng)用傳輸接口程序硬件環(huán)境：能夠運(yùn)行在小型機(jī)、PC機(jī)等硬件環(huán)境上。 三級(jí)應(yīng)用傳輸服務(wù)程序?qū)⑦\(yùn)行在分局、路局、部中心三級(jí)的MQ通信服務(wù)器上，是常駐進(jìn)程。當(dāng)應(yīng)用程序有數(shù)據(jù)要發(fā)送或接收時(shí)，調(diào)用此接口。對于較大的文件，該軟件還支持大文件分段傳輸；與應(yīng)用傳輸服務(wù)程序相結(jié)合，實(shí)現(xiàn)多地址分發(fā)的功能；若遇到隊(duì)列滿、隊(duì)列不可用、隊(duì)列正在用等臨時(shí)錯(cuò)誤情況時(shí)，會(huì)自動(dòng)RETRY； 支持MQ SERVER和MQ CLIENT兩種方式； 為應(yīng)用提供源程序、動(dòng)態(tài)連接庫等調(diào)用方式。（4） 有較強(qiáng)的容錯(cuò)能力，保證了系統(tǒng)的高可靠性。因此本系統(tǒng)在設(shè)計(jì)過程中，充分考慮了上述的因素，力求做到在實(shí)施中的可操作性。 系統(tǒng)特點(diǎn)（1）兼容性：TMIS的各應(yīng)用系統(tǒng)離不開數(shù)據(jù)傳輸，由于TMIS有的應(yīng)用項(xiàng)目已經(jīng)投產(chǎn)運(yùn)行，在運(yùn)輸生產(chǎn)當(dāng)中發(fā)揮著重要的作用，有的正處于建設(shè)、實(shí)施的過程中，因此本系統(tǒng)在設(shè)計(jì)過程中，充分考慮了上述的因素，盡可能地做到新舊兼容，使已經(jīng)投產(chǎn)的應(yīng)用少做改動(dòng)。統(tǒng)一TMIS傳輸平臺(tái)軟件涉及應(yīng)用傳輸服務(wù)、應(yīng)用傳輸接口、MQ傳輸監(jiān)控及日志統(tǒng)計(jì)等幾大模塊。 本項(xiàng)目的任務(wù)提出、組織、開發(fā)者為鐵道部信息技術(shù)中心。每個(gè)應(yīng)用項(xiàng)目采用的通信方式各不相同，有的甚至使用不同的通信服務(wù)器。應(yīng)用方式的變化要求TMIS通信方案必須進(jìn)行必要的調(diào)整。根據(jù)新調(diào)整的TMIS總體方案，確定在部、路局和分局建立三級(jí)貨票庫、確報(bào)庫、自動(dòng)車號(hào)識(shí)別信息庫和動(dòng)態(tài)車輛庫，致使應(yīng)用系統(tǒng)的數(shù)據(jù)流向發(fā)生重大變化。 基于MQ的統(tǒng)一傳輸平臺(tái)軟件用戶手冊基于MQ的統(tǒng)一傳輸平臺(tái)軟件用戶手冊鐵道部信息技術(shù)中心二00三年三月目 錄一 系統(tǒng)簡介 3 前言 3 系統(tǒng)特點(diǎn) 3 系統(tǒng)功能 3（Application Transmission Interface） 3 4 運(yùn)行環(huán)境要求 4 約定 5 注意 5二 安裝與啟動(dòng) 5 準(zhǔn)備工作 5 安裝過程 5 UNIX系統(tǒng) 5 Windows系統(tǒng) 6 安裝后軟件的目錄結(jié)構(gòu)及用途 11 Unix系統(tǒng) 11 Windows系統(tǒng) 12 日志文件 13 參數(shù)文件 13 初始化文件 14 參數(shù)文件及初始化文件的配置 14 14 14 初始化文件的格式及內(nèi)容說明 15 MQ的配置 20 本地隊(duì)列 20 遠(yuǎn)程隊(duì)列（發(fā)送隊(duì)列） 20 20 軟件的啟動(dòng)和停止 21 Unix系統(tǒng) 21 Windows系統(tǒng) 22三 維護(hù)與管理 28四 標(biāo)準(zhǔn)應(yīng)用傳輸通信接口程序的使用 30 介紹 30 標(biāo)準(zhǔn)函數(shù)接口 31 ATISEND 31 ATISEND1 34 ATIRCV 34 ATIRCV1 37 使用方法 38 使用C語言源代碼 38 使用動(dòng)態(tài)連接庫(C語言) 42 WINDOWS系統(tǒng)下使用動(dòng)態(tài)連接庫(VB ) 44 參數(shù)文件 44附錄一 44附錄二 50附錄三 51一 系統(tǒng)簡介 前言 TMIS信息系統(tǒng)建設(shè)初期設(shè)計(jì)的通信方式是以建立集中式中央實(shí)時(shí)數(shù)據(jù)庫體系結(jié)構(gòu)為基礎(chǔ)的。鐵路分局乃至基層站段所有TMIS信息系統(tǒng)的信息端點(diǎn)（報(bào)告點(diǎn)、查詢點(diǎn)），和TMIS中央系統(tǒng)進(jìn)行信息傳輸。站段原始信息不但要上報(bào)鐵道部，還要在分局、路局落地入庫。TMIS建設(shè)初期，應(yīng)用項(xiàng)目的開發(fā)基本上是縱向進(jìn)行的，實(shí)施時(shí)自下而上或自上而下，從車站到分局、路局或部中心。因此，為了適應(yīng)新調(diào)整的TMIS總體方案，鐵道部信息技術(shù)中心及領(lǐng)導(dǎo)提出了必須建立統(tǒng)一的TMIS傳輸平臺(tái)，為各應(yīng)用的數(shù)據(jù)傳輸提供高質(zhì)量、高可靠的服務(wù)的戰(zhàn)略方針。該項(xiàng)目的用戶為TMIS各應(yīng)用開發(fā)組及部中心、全路各路局、分局、TMIS信息報(bào)告站等。各模塊之間既有聯(lián)系，也相對獨(dú)立。（2）可操作性：應(yīng)用系統(tǒng)在全路的實(shí)施過程中不可能做到一夜之間全部完成，需要有一定的時(shí)間周期；有些已投產(chǎn)的應(yīng)用系統(tǒng)的數(shù)據(jù)傳輸模式在向新的統(tǒng)一傳輸平臺(tái)轉(zhuǎn)換時(shí)，也需要有一個(gè)轉(zhuǎn)換的過程。（3）較強(qiáng)的適應(yīng)性：TMIS各應(yīng)用系統(tǒng)的特點(diǎn)不同，其數(shù)據(jù)傳輸?shù)哪Ｊ揭膊槐M相同，有三級(jí)落地轉(zhuǎn)發(fā)模式，有點(diǎn)到點(diǎn)的傳輸模式，還有跨節(jié)點(diǎn)的傳輸模式等，本系統(tǒng)能夠適應(yīng)上述的各種模式。 系統(tǒng)功能（Application Transmission Interface）統(tǒng)一TMIS數(shù)據(jù)傳輸格式；為應(yīng)用屏蔽MQ，盡可能地簡化用戶在數(shù)據(jù)傳輸過程中的調(diào)用接口，做到用戶只需填寫做什么、從哪發(fā)、發(fā)到哪、怎么發(fā)既可；通過對要傳輸數(shù)據(jù)源地址和目的地址的填寫，為實(shí)現(xiàn)TMIS數(shù)據(jù)自動(dòng)轉(zhuǎn)發(fā)和分發(fā)打下了基礎(chǔ)；該軟件支持消息到消息的傳輸，結(jié)合不同應(yīng)用對接收消息的處理入庫模塊后，即完成了TMIS數(shù)據(jù)庫到庫的傳輸；除此之外，該軟件還支持文件到文件的傳輸、消息到文件的傳輸、文件到消息的傳輸?shù)取４私涌诳梢蕴峁┙o新上的TMIS應(yīng)用或改為用MQ傳輸TMIS數(shù)據(jù)的應(yīng)用使用。能夠運(yùn)行在AIX、SCO UNIX、WINDOW S等平臺(tái)上。負(fù)責(zé)對消息進(jìn)行上傳、下發(fā)、落地等處理； 可按下述轉(zhuǎn)發(fā)規(guī)則進(jìn)行轉(zhuǎn)發(fā)：同分局車站由分局轉(zhuǎn)發(fā)；跨分局的信息由本路局轉(zhuǎn)發(fā)；跨路局的信息由鐵道部轉(zhuǎn)發(fā)； 同時(shí)支持點(diǎn)到點(diǎn)及跨節(jié)點(diǎn)傳輸模式；按應(yīng)用需求靈活處理信息是否落地問題；支持多地址轉(zhuǎn)發(fā)； MQ消息傳輸日志 將通過MQ接收通道傳輸過來的消息的相關(guān)信息，如：消息的目的地址、消息的發(fā)送者和發(fā)送時(shí)間等信息記錄下來，定時(shí)打包發(fā)送到部中心，入庫，并通過頁面查詢。軟件環(huán)境：適用于UNIX、WINDOWS等平臺(tái)，需安裝MQ SERVER 或MQ CLIENT軟件。軟件環(huán)境：AIX、WINDOWS NT SERVER 企業(yè)版、WINDOWS 2000，需安裝MQ SERVER。注意：對于NT SERVER 企業(yè)版，還要在系統(tǒng)環(huán)境變量中加上一條：TMQ_DEFAULT_MODEL=FIXEDRS/6000平臺(tái)推薦使用AIX +MQ +CSD07 或AIX + MQ + CSD04。 約定調(diào)用應(yīng)用傳輸接口時(shí)：(1) 源地址和目的地址的填寫應(yīng)該是全地址名。采用TMIS標(biāo)準(zhǔn)站名代碼。(2) 消息傳輸?shù)淖畲笙㈤L度為4M。應(yīng)用傳輸服務(wù)程序：(1) 對消息進(jìn)行多地址分發(fā)時(shí)，目前一次最多支持24個(gè)地址。 注意本系統(tǒng)的安裝和使用者需要對WINDOWS、UNIX操作系統(tǒng)、MQ軟件等有一定的了解。雙機(jī)環(huán)境或單機(jī)環(huán)境下，放置atserver數(shù)據(jù)文件的共享盤或內(nèi)置盤有足夠的空間，最好大于等于120M。其中的文件需放在本地內(nèi)置盤上。(1) 進(jìn)入超級(jí)用戶“root”，在“mqm”用戶的根目錄（如/home/mqm）下運(yùn)行：tar –xvf 解壓縮，自動(dòng)生成atserver目錄，該目錄下有可執(zhí)行程序atsvr、atdfh、zmzdrcv、atmon、putlogtoq；庫文件msglog和腳本文件startmon、stopmon、rmmail，在/、。(3) 在共享盤上建立大于120M的文件系統(tǒng)，一般情況下可以使用安裝MQ系統(tǒng)時(shí)所建的/mqfs1，若現(xiàn)有空間不大，最好再擴(kuò)120M。 atserver目錄下有參數(shù)文件ruler、。：然后出現(xiàn)歡迎界面：點(diǎn)擊Next進(jìn)入注冊界面：填寫好 User Name 和 Company Name 后，點(diǎn)擊Next進(jìn)入選擇軟件安裝路徑界面：此界面顯示的Destination Folder，可以選擇和修改，它是指存放參數(shù)文件和日志等數(shù)據(jù)文件的目錄，應(yīng)選擇放在共享盤上的atserver子目錄下，包括參數(shù)文件ruler、。如C：\WINNT，、如：C：\WINNT\SYSTEM32。 安裝后軟件的目錄結(jié)構(gòu)及用途無論使用哪種通信服務(wù)器，軟件安裝完成后，分為兩部分，可執(zhí)行程序?qū)⒎旁诒镜赜脖P上，參數(shù)文件等將放在共享盤上。atdfh —— 死信文件處理程序。atmon —— 監(jiān)控atsvr 和atdfh的程序，atsvr 和atdfh進(jìn)程如果中斷，該程序會(huì)自動(dòng)重新將它們啟動(dòng)起來。應(yīng)加在MQ消息通道接收端的消息出口處，獲取經(jīng)過接收通道的消息的相關(guān)信息，并記錄在日志文件中。與msglog相配合，兩者必須同時(shí)使用或不用。stopmon —— 停止運(yùn)行atsvr和atdfh程序的腳本文件。 Windows系統(tǒng)設(shè)本地硬盤上操作系統(tǒng)所在的盤符為“C：\”，共享盤的盤符為“D：\”，則安裝及運(yùn)行后產(chǎn)生的目錄結(jié)構(gòu)如下：C:\——atserver\———— |—— |—— |—— |——C:\WINNT\———— |——C:\WINNT\SYSTEM32\———— |—— |—— D:\——atserver\———— |—— |—— ruler |—— atproc\——— |—— |—— |—— tail_id|—— head_id|—— deadfile\|—— lostfile\|—— log\————atwork**.log|——errmsg**.log|——dfwork**.log內(nèi)置盤上文件的用途及說明： —— 應(yīng)用消息傳輸處理服務(wù)程序。 —— 自動(dòng)更新參數(shù)文件如:站名字典文件的程序。應(yīng)加在MQ消息通道接收端的消息出口處，獲取經(jīng)過接收通道的消息的相關(guān)信息，并記錄在日志文件中。與msglog相配合，必須同時(shí)使用或不用。如：tail_id、head_id文件；deadfile、lostfile、log子目錄。“**”表示序號(hào)。head_id—— atsvr、atdfh程序使用。lostfile —— 存放垃圾文件的目錄。atwork**.log —— 記錄atsvr程序運(yùn)行情況的日志文件。errmsg**.log ——atsvr處理消息產(chǎn)生錯(cuò)誤時(shí)，記錄消息的相關(guān)信息的日志文件。各參數(shù)文件的用途如下： —— 站名字典文件 —— 虛擬分局（無分局的路局）代碼文件。 —— 應(yīng)用狀態(tài)配置文件。 —— 傳輸服務(wù)程序atsvr看護(hù)的隊(duì)列名文件。、。 參數(shù)文件及初始化文件的配置軟件安裝完后，緊接著應(yīng)按本地的實(shí)際情況，做上述各參數(shù)文件的配置及修改。特別注意：啟動(dòng)atsvr和atdfh之前， 、。參數(shù)文件中“”和“！”字符有專門的用途，只在每行的第一個(gè)字母時(shí)有效，“”符表示該行為注釋行；“！”符表示參數(shù)文件結(jié)束，“！”符后面的字符不起作用?！摂M分局TMIS碼(表示無分局的路局的一個(gè)虛擬分局碼,在TMIS基礎(chǔ)數(shù)據(jù)字典中有定義)配置文件，每行代表一個(gè)虛擬分局TMIS碼，需要填寫所有的虛擬分局碼。1： 應(yīng)用消息在本地是否落地入庫，“0”表示本地應(yīng)用不需要消息，此時(shí)atsvr程序不會(huì)將消息放入應(yīng)用隊(duì)列；“1”表示本地應(yīng)用