【正文】 式及內(nèi)容說明(1) ——日志程序參數(shù)文件。2： 本地級別說明，共分4級：“4”代表鐵道部、“3”代表路局、“2”代表分局、“1”代表車站；QM01：本地MQ通信服務(wù)器的隊列管理者名，必須大寫?！?本節(jié)點信息文件，用于描述本節(jié)點的一些信息，此配置文件中只能有一行配置信息?！?站名字典文件，內(nèi)容是電報碼和TMIS碼對照表，該參數(shù)文件不需要用戶自己配制，由zmzdrcv程序自動更新。、。 初始化文件。ruler —— 為運行MQ系統(tǒng)提供的runmqdlq程序，所做的配置文件。dfwork**.log —— 記錄atdfh程序運行情況的日志文件。deadfile —— 存放死信文件的目錄。在log子目錄下生成atwork**.log、errmsg**.log、dfwork**.log日志文件。 —— 發(fā)送日志文件程序，將msglog記錄的日志文件發(fā)送到指定隊列中。 —— 死信文件處理服務(wù)程序。startmon —— 啟動atsvr和atdfh程序的腳本文件。msglog —— MQ接收通道消息出口程序。 Unix系統(tǒng)假設(shè)本地硬盤上“mqm”用戶的根目錄為“/home/mqm”，共享盤的根目錄為“/mqfs1”，則安裝及運行后產(chǎn)生的目錄結(jié)構(gòu)如下：/home/mqm/——atserver/————atsvr |——atdfh |——zmzdrcv |——atmon |——putlogtoq |——msglog |——startmon |——stopmon |—— |——rmmail/etc/————（大寫） |——（大寫）/mqfs1/——atserver/——— |—— |—— ruler |—— atproc/——— |—— |—— |—— tail_id|—— head_id|—— deadfile/|—— lostfile/|—— log/———atwork**.log|——errmsg**.log|——dfwork**.log內(nèi)置盤上文件的用途說明：atsvr —— 應(yīng)用消息傳輸處理程序。（可執(zhí)行程序不受此限制，它們將自動被放在系統(tǒng)盤的atserver目錄下，、。(4) 然后在共享盤的文件系統(tǒng)的根目錄下運行：tar –xvf 進行解壓縮，自動生成atserver一級目錄和atproc二級子目錄。，其中的文件最好放在共享盤上。 二 安裝與啟動 準(zhǔn)備工作安裝前保證操作系統(tǒng)運行正常、MQ軟件安裝完畢且運行正常。(3) 進行文件傳輸時，目的文件的文件名長度不能超過15字節(jié)。既某路局某分局某車站。推薦使用WINDOWS 2000+SP2+MQ +CSD04，也可用WINDOWS NT SERVER +SP6A +MQ +CSD07。 運行環(huán)境要求(1) 應(yīng)用傳輸接口程序硬件環(huán)境：能夠運行在小型機、PC機等硬件環(huán)境上。當(dāng)應(yīng)用程序有數(shù)據(jù)要發(fā)送或接收時，調(diào)用此接口。（4） 有較強的容錯能力，保證了系統(tǒng)的高可靠性。 系統(tǒng)特點（1）兼容性：TMIS的各應(yīng)用系統(tǒng)離不開數(shù)據(jù)傳輸，由于TMIS有的應(yīng)用項目已經(jīng)投產(chǎn)運行，在運輸生產(chǎn)當(dāng)中發(fā)揮著重要的作用，有的正處于建設(shè)、實施的過程中，因此本系統(tǒng)在設(shè)計過程中，充分考慮了上述的因素，盡可能地做到新舊兼容，使已經(jīng)投產(chǎn)的應(yīng)用少做改動。 本項目的任務(wù)提出、組織、開發(fā)者為鐵道部信息技術(shù)中心。應(yīng)用方式的變化要求TMIS通信方案必須進行必要的調(diào)整。 基于MQ的統(tǒng)一傳輸平臺軟件用戶手冊基于MQ的統(tǒng)一傳輸平臺軟件用戶手冊鐵道部信息技術(shù)中心二00三年三月目 錄一 系統(tǒng)簡介 3 前言 3 系統(tǒng)特點 3 系統(tǒng)功能 3（Application Transmission Interface） 3 4 運行環(huán)境要求 4 約定 5 注意 5二 安裝與啟動 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 本地隊列 20 遠程隊列（發(fā)送隊列） 20 20 軟件的啟動和停止 21 Unix系統(tǒng) 21 Windows系統(tǒng) 22三 維護與管理 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 使用動態(tài)連接庫(C語言) 42 WINDOWS系統(tǒng)下使用動態(tài)連接庫(VB ) 44 參數(shù)文件 44附錄一 44附錄二 50附錄三 51一 系統(tǒng)簡介 前言 TMIS信息系統(tǒng)建設(shè)初期設(shè)計的通信方式是以建立集中式中央實時數(shù)據(jù)庫體系結(jié)構(gòu)為基礎(chǔ)的。站段原始信息不但要上報鐵道部，還要在分局、路局落地入庫。因此，為了適應(yīng)新調(diào)整的TMIS總體方案，鐵道部信息技術(shù)中心及領(lǐng)導(dǎo)提出了必須建立統(tǒng)一的TMIS傳輸平臺，為各應(yīng)用的數(shù)據(jù)傳輸提供高質(zhì)量、高可靠的服務(wù)的戰(zhàn)略方針。各模塊之間既有聯(lián)系，也相對獨立。（3）較強的適應(yīng)性：TMIS各應(yīng)用系統(tǒng)的特點不同，其數(shù)據(jù)傳輸?shù)哪Ｊ揭膊槐M相同，有三級落地轉(zhuǎn)發(fā)模式，有點到點的傳輸模式，還有跨節(jié)點的傳輸模式等，本系統(tǒng)能夠適應(yīng)上述的各種模式。此接口可以提供給新上的TMIS應(yīng)用或改為用MQ傳輸TMIS數(shù)據(jù)的應(yīng)用使用。負責(zé)對消息進行上傳、下發(fā)、落地等處理； 可按下述轉(zhuǎn)發(fā)規(guī)則進行轉(zhuǎn)發(fā)：同分局車站由分局轉(zhuǎn)發(fā)；跨分局的信息由本路局轉(zhuǎn)發(fā)；跨路局的信息由鐵道部轉(zhuǎn)發(fā)； 同時支持點到點及跨節(jié)點傳輸模式；按應(yīng)用需求靈活處理信息是否落地問題；支持多地址轉(zhuǎn)發(fā)； MQ消息傳輸日志 將通過MQ接收通道傳輸過來的消息的相關(guān)信息，如：消息的目的地址、消息的發(fā)送者和發(fā)送時間等信息記錄下來，定時打包發(fā)送到部中心，入庫，并通過頁面查詢。軟件環(huán)境：AIX、WINDOWS NT SERVER 企業(yè)版、WINDOWS 2000，需安裝MQ SERVER。 約定調(diào)用應(yīng)用傳輸接口時：(1) 源地址和目的地址的填寫應(yīng)該是全地址名。(2) 消息傳輸?shù)淖畲笙㈤L度為4M。 注意本系統(tǒng)的安裝和使用者需要對WINDOWS、UNIX操作系統(tǒng)、MQ軟件等有一定的了解。其中的文件需放在本地內(nèi)置盤上。(3) 在共享盤上建立大于120M的文件系統(tǒng)，一般情況下可以使用安裝MQ系統(tǒng)時所建的/mqfs1，若現(xiàn)有空間不大，最好再擴120M。：然后出現(xiàn)歡迎界面：點擊Next進入注冊界面：填寫好 User Name 和 Company Name 后，點擊Next進入選擇軟件安裝路徑界面：此界面顯示的Destination Folder，可以選擇和修改，它是指存放參數(shù)文件和日志等數(shù)據(jù)文件的目錄，應(yīng)選擇放在共享盤上的atserver子目錄下，包括參數(shù)文件ruler、。 安裝后軟件的目錄結(jié)構(gòu)及用途無論使用哪種通信服務(wù)器，軟件安裝完成后，分為兩部分，可執(zhí)行程序?qū)⒎旁诒镜赜脖P上，參數(shù)文件等將放在共享盤上。atmon —— 監(jiān)控atsvr 和atdfh的程序，atsvr 和atdfh進程如果中斷，該程序會自動重新將它們啟動起來。與msglog相配合，兩者必須同時使用或不用。 Windows系統(tǒng)設(shè)本地硬盤上操作系統(tǒng)所在的盤符為“C：\”，共享盤的盤符為“D：\”，則安裝及運行后產(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ù)程序。應(yīng)加在MQ消息通道接收端的消息出口處，獲取經(jīng)過接收通道的消息的相關(guān)信息，并記錄在日志文件中。如：tail_id、head_id文件；deadfile、lostfile、log子目錄。head_id—— atsvr、atdfh程序使用。atwork**.log —— 記錄atsvr程序運行情況的日志文件。各參數(shù)文件的用途如下： —— 站名字典文件 —— 虛擬分局（無分局的路局）代碼文件。 —— 傳輸服務(wù)程序atsvr看護的隊列名文件。 參數(shù)文件及初始化文件的配置軟件安裝完后，緊接著應(yīng)按本地的實際情況，做上述各參數(shù)文件的配置及修改。參數(shù)文件中“”和“！”字符有專門的用途，只在每行的第一個字母時有效，“”符表示該行為注釋行；“！”符表示參數(shù)文件結(jié)束，“！”符后面的字符不起作用。1： 應(yīng)用消息在本地是否落地入庫，“0”表示本地應(yīng)用不需要消息，此時atsvr程序不會將消息放入應(yīng)用隊列；“1”表示本地應(yīng)用需要消息，atsvr程序自動將消息放入應(yīng)用隊列；APPLJZXQ：是本地應(yīng)用接收消息隊列名；RJZX：atsvr程序轉(zhuǎn)發(fā)消息時使用的遠程隊列名的前綴。分局為TMIS兩位數(shù)字碼，路局為TMIS一位字母碼，如哈爾濱路局“B”。用戶還可以根據(jù)實際情況，按此格式對內(nèi)容進行增減。(2) —— 應(yīng)用傳輸接口程序的參數(shù)文件。參數(shù)文件中不同的應(yīng)用可以設(shè)置自己的配置信息，放到不同的區(qū)段中，同時有一個默認(rèn)的配置，存放公共配置信息。[DEFAULT SET]QMNAME=OS=WINNTATIVersion=1retryCount=0MAX_FILE_BLOCK_SIZE=50506。參數(shù)文件中的某一行中只有參數(shù)名或參數(shù)名+“=”的方式，如：“OS=”或“OS”都表示將此參數(shù)設(shè)置為空，如果取消某一個參數(shù)的取值，可以采用注釋的方式。ATI_SEND_RETRY_TIMES=0或沒有此參數(shù)的設(shè)置，在發(fā)送不成功后，發(fā)送函數(shù)將不重新發(fā)送，直接將第一次發(fā)送的結(jié)果(返回碼和MQ錯誤碼)返回到用戶的程序中。由于在MQ中，隊列的名稱字母大小寫是區(qū)分的，所以RQNAME的參數(shù)值需要寫出大小正確的隊列名稱。QMNAME： 當(dāng)前隊列管理器的名稱。目前支持兩個版本：ATIVersion=0和ATIVersion=1。LOCALADDRESS： 本地的通信地址。WaitInterval： 設(shè)置接收函數(shù)以等待的方式接收數(shù)據(jù)時，要等待的時間。無論要傳送的文件是多大，最多只能分割成99塊。加大此參數(shù)設(shè)置值在傳輸小文件時，不會造成傳輸信道明顯的浪費。Dest_Addr_Plugin Dest_Addr_Plugin_LIB_NAME Dest_Addr_Plugin_FUNCTION_NAME 以上三個參數(shù)為系統(tǒng)保留，請保持參數(shù)被注釋或 Dest_Addr_Plugin=N。由于zmzdrcv程序需要用到此參數(shù)文件，因此在通信服務(wù)器上的軟件安裝好后，應(yīng)對此參數(shù)文件的[MQZM]區(qū)段進行修改，填上“QMNAME=”參數(shù)，為本地隊列管理器名。Dest_Addr_Plugin_LIB_NAME=。 本地隊列 通信服務(wù)器上的本地隊列大致分為兩類：一類為atsvr程序守護的隊列，即atsvr程序從該隊列中接收消息。在各級的通信服務(wù)器上都要為它們定義一個這樣的隊列，其命名規(guī)則為：以“APPL”作為前綴，其后為應(yīng)用標(biāo)識碼，如：“APPLJZXQ”。 遠程隊列（發(fā)送隊列）在各級的通信服務(wù)器上，還要為每個應(yīng)用系統(tǒng)定義一套到相鄰節(jié)點的遠程隊列，用于消息的轉(zhuǎn)發(fā)。除此之外，若要使用putlogtoq，則還