【正文】 39。 Author: WANG Yunqiu39。H8Public Const ATI_ERROR_BASE = 3300Public Const ATI_OPEN_TRANS_FILE_ERROR = (ATI_ERROR_BASE + 18)Public Const ATI_TOO_MANY_DEST_ADDRESS = (ATI_ERROR_BASE + 19)Public Const ATI_NO_MORE_MESSAGE_IN_QUEUE = 100Public Const ATI_PUT_MSG_ERROR_BACK = (ATI_ERROR_BASE + 200)Public Const ATI_MSG_TRUNCATED = (ATI_ERROR_BASE + 201)Public Const ATI_INIT_INIFILE_ERROR = (ATI_ERROR_BASE + 20)Public Const ATI_CONNECT_TO_SERVER_ERROR = (ATI_ERROR_BASE + 21)Public Const ATI_DISC_ERR_IN_OPEN_S_Q_ERR = (ATI_ERROR_BASE + 22)Public Const ATI_FIRST_GET_MSG_ERROR = (ATI_ERROR_BASE + 23)Public Const ATI_SECOND_NO_MORE_MSG_ERR = (ATI_ERROR_BASE + 24)Public Const ATI_SECOND_GET_MSG_ERR = (ATI_ERROR_BASE + 25)Public Const ATI_SEEK_TRANS_FILE_ERROR = (ATI_ERROR_BASE + 26)Public Const ATI_GET_RQNAME_ERROR = (ATI_ERROR_BASE + 27)Public Const ATI_GET_ATIVersion_ERROR = (ATI_ERROR_BASE + 28)Public Const ATI_BEGIN_UNIT_WORK_ERR = (ATI_ERROR_BASE + 29)Public Const ATI_ALLOC_BUFFER_ERROR = (ATI_ERROR_BASE + 30)Public Const ATI_PUT_MSG_ERROR = (ATI_ERROR_BASE + 31)Public Const ATI_COMMIT_WORK_ERROR = (ATI_ERROR_BASE + 32)39。 // DefaultPublic Const ATI_RECEIVE_NO_WAIT = amp。H0 39。 Receive FuncCodePublic Const ATI_SEND_MESSAGE = amp。 atircv139。 atisendtest39。==============================39。附錄一 Attribute VB_Name = AMQATIOption Explicit39。使用Windows 9x系統(tǒng)時最好將此文件存放在 %WINDIR%\SYSTEM下，使用Windows NT/2K/XP系統(tǒng)時，最好將此文件存放在 %WINDIR%\SYSTEM32下。選擇確定(OK)按鈕。 使用方法使用通信接口程序可以采用源代碼的方式(C語言)，也可以采用動態(tài)連接庫的方式。此函數(shù)是用來從MQ中接收消息/文件與ATIRCV不同的是，此函數(shù)必須指明參數(shù)文件的路徑和文件名。Buffer：輸入?yún)?shù)，字符數(shù)組，接收文件時，此參數(shù)指明文件的存放目錄，接收消息到內(nèi)存時，此參數(shù)為內(nèi)存地址。其中前兩個字節(jié)是MQ的TaskId為系統(tǒng)保留。Buffer = c:\MyAppPath\Temp + chr$(0) + space(24)。此參數(shù)僅在接收消息(ATI_RECEIVE_MESSAGE)和接收一個文件(ATI_RECEIVE_FILE + ATI_RECEIVE_ONE_FILE)時有效，連續(xù)接收多個文件時無效。ATI_RECEIVE_MESSAGE_ID (0x0020)：接收數(shù)據(jù)時，如果需要接收到消息的MsgID，請在FuncCode中加上此指示。ATI_RECEIVE_ONE_FILE (0x00A0)：在接收文件時，只接收一個文件，接收程序會接受所有的需要的消息，直到完成第一個完整的文件為止。隊列中沒有時，函數(shù)返回：NO_MORE_MESSAGE_IN_QUEUE。 ATIRCVVB接口：ATIRCV (ByVal FuncCode As Integer, ByVal TaskId As String, _ByVal BufferLen As Long, _ByVal Buffer As String, _ByRef DataLen As Long, _ByRef Reason As Long) _ As LongC 接口：Int ATIRCV (short FuncCode, char * TaskId, long BufferLen, char * Buffer, long * DataLen, long * Reason)。VB接口：ATISEND1 (ByVal FuncCode As Integer, _ByVal TaskId As String, _ByVal Dest_num As Long, _ByVal Destation As String, _ByVal SourceFileDir As String, _ByVal SourceData As String, _ByVal DataLen As Long, _ByVal DestFileName As String, _ByVal INIFileName, _ByRef Reason As Long)As LongC 接口： int ATISEND1 (short FuncCode, char * TaskId, int Dest_num,char * Destation, char * SourceFileDir, char * SourceData,int DataLen, char * DestFileName,char * INIFileName, long * Reason)。DestFileName：輸入?yún)?shù)，字符串類型，最多不能超過15個字節(jié)。傳輸內(nèi)存數(shù)據(jù)/消息時，此參數(shù)沒有實際意義。在一條消息中如果有任一地址為三級落地轉(zhuǎn)發(fā)模式(1)，那么這個消息即為三級落地轉(zhuǎn)發(fā)模式的消息。● FuncCode不含有ATI_SEND_TO_QUEUE的值時，此參數(shù)中傳入目標地址碼。其中前兩個字節(jié)是MQ的TaskId為系統(tǒng)保留。ATI_SEND_TO_QUEUE(0x0002)：發(fā)送的目標地址是一個隊列名稱，請參見Destation參數(shù)說明。在標準接口程序中，無論是那種語言，都有以下的標準接口函數(shù)：1． ATISEND 2． ATISEND13． ATIRCV4． ATIRCV1在以下的說明中，我們首先介紹四個標準的編程接口函數(shù)及其參數(shù)，然后介紹上述三種語言接口的適用方法，最后介紹系統(tǒng)配置文件的配置方法。四 標準應(yīng)用傳輸通信接口程序的使用 介紹 標準應(yīng)用傳輸通信接口程序是為配合制訂統(tǒng)一的通信傳輸平臺而開發(fā)的接口程序。當MQ管理人員發(fā)現(xiàn)傳輸異常，如：“CS*Q”中消息堆積、“APPL*Q”中沒收到消息等，都可通過查看atwork**.log的方式判斷問題所在。當發(fā)現(xiàn)死信隊列中有消息時，可輸入如下命令：runmqdlq ruler 建議：實施時，可以分兩步進行，日志文件部分即msglog()和putlogtoq()程序可待系統(tǒng)運行一段時間較穩(wěn)定后再上。此后，該程序?qū)⒚扛粢恍r自動執(zhí)行一次。(2) 與unix相同，msglog ，將消息的相關(guān)信息記錄到日志文件中。atsvr ——服務(wù)名。前提條件是：MQ配置正確，并且啟動MQ觸發(fā)監(jiān)視器： runmqtrm –q APPLINITQ(6) MQ系統(tǒng)提供了死信隊列處理程序，可以按用戶提供的規(guī)則處理死信隊列中的消息，試著將它們重新放到目的隊列中。(3) msglog ，將消息的相關(guān)信息記錄到日志文件中。/mqfs1/atserver/atproc —— atmon程序的第二個參數(shù)，表明atsvr和atdfh程序需要的參數(shù)文件的路徑，這里指的是共享盤上參數(shù)文件的絕對路徑名。nohup —— Unix系統(tǒng)命令，制定其后要運行的程序，在啟動程序的用戶或終端關(guān)閉的情況下，不被系統(tǒng)掛起或退出。例如：若貨票應(yīng)用使用MQ傳輸，則最好單獨再定義一對通道。，都應(yīng)事先用MQ命令定義好。對于已經(jīng)使用MQ傳輸?shù)膽?yīng)用系統(tǒng)，在切換到統(tǒng)一傳輸平臺上時，針對各自的情況，修改應(yīng)用參數(shù)，使應(yīng)用程序改從APPL*Q隊列中接收消息，將原先應(yīng)用使用的隊列通過別名指向CS*Q。都應(yīng)事先用MQ命令定義好。SYNCPOINT=0。 if MQWaitInterval = 1, ATIRCV will always wait. (ms)WaitInterval=15000MAX_FILE_BLOCK_SIZE=20480。如果在隨后的對該文件的重試發(fā)送中成功發(fā)送了，在此之前對該文件的發(fā)送失敗可以忽略。l SHARED_MESSAGE=2：本次發(fā)送只發(fā)送一份消息，每一條消息中記錄了所有的消息地址。例如，當要傳送最大可達5M的文件時，傳輸塊最小為5000000/99即50506字節(jié)，最佳傳輸大小為：5000000/20=250000，約250K字節(jié)。WaitInterval=1表示以無限期的方式等待。RetryCount： 與ATISEND的發(fā)送出錯重試無關(guān)。ATIVersion=1表示發(fā)送到隊列的數(shù)據(jù)已經(jīng)改變?yōu)樾碌母袷?。用“QMNAME=”表示當前系統(tǒng)中默認的隊列管理器。同RQNAME，LQNAME的參數(shù)值也是大小寫區(qū)分的。RQNAME： 消息要發(fā)送到的隊列名，即發(fā)送函數(shù)要PUT的隊列名稱。所有配置參數(shù)的名稱大小寫無關(guān)，參數(shù)：ATI_SEND_RETRY_TIMES與ATI_Send_Retry_Times是指同一個參數(shù)，但參數(shù)的設(shè)置值的大小寫是否有關(guān)由應(yīng)用程序自己定義。如上例中的默認區(qū)段“[DEFAULT SET]”，集裝箱區(qū)段“[JZX]”。當默認配置中的參數(shù)與應(yīng)用區(qū)段中的配置相互沖突時，以應(yīng)用區(qū)段中的配置為準?！鳛樽⑨專啃械拈_始和結(jié)束的空格、TAB、回車換行等都會被自動過濾。共有四行參數(shù), 每行不能超過80個字節(jié)。 —— atsvr程序需要看護的隊列名配置文件，每行寫一個隊列名。以哈爾濱分局為例，其格式為： “01 2 QM01”?！摂M分局TMIS碼(表示無分局的路局的一個虛擬分局碼,在TMIS基礎(chǔ)數(shù)據(jù)字典中有定義)配置文件，每行代表一個虛擬分局TMIS碼，需要填寫所有的虛擬分局碼。特別注意：啟動atsvr和atdfh之前， 、。、。 —— 應(yīng)用狀態(tài)配置文件。errmsg**.log ——atsvr處理消息產(chǎn)生錯誤時，記錄消息的相關(guān)信息的日志文件。lostfile —— 存放垃圾文件的目錄?！?*”表示序號。與msglog相配合，必須同時使用或不用。 —— 自動更新參數(shù)文件如:站名字典文件的程序。stopmon —— 停止運行atsvr和atdfh程序的腳本文件。應(yīng)加在MQ消息通道接收端的消息出口處，獲取經(jīng)過接收通道的消息的相關(guān)信息，并記錄在日志文件中。atdfh —— 死信文件處理程序。如C：\WINNT，、如：C：\WINNT\SYSTEM32。 atserver目錄下有參數(shù)文件ruler、。(1) 進入超級用戶“root”，在“mqm”用戶的根目錄（如/home/mqm）下運行：tar –xvf 解壓縮，自動生成atserver目錄，該目錄下有可執(zhí)行程序atsvr、atdfh、zmzdrcv、atmon、putlogtoq；庫文件msglog和腳本文件startmon、stopmon、rmmail，在/、。雙機環(huán)境或單機環(huán)境下，放置atserver數(shù)據(jù)文件的共享盤或內(nèi)置盤有足夠的空間，最好大于等于120M。應(yīng)用傳輸服務(wù)程序：(1) 對消息進行多地址分發(fā)時，目前一次最多支持24個地址。采用TMIS標準站名代碼。注意：對于NT SERVER 企業(yè)版，還要在系統(tǒng)環(huán)境變量中加上一條：TMQ_DEFAULT_MODEL=FIXEDRS/6000平臺推薦使用AIX +MQ +CSD07 或AIX + MQ + CSD04。軟件環(huán)境：適用于UNIX、WINDOWS等平臺，需安裝MQ SERVER 或MQ CLIENT軟件。能夠運行在AIX、SCO UNIX、WINDOW S等平臺上。 系統(tǒng)功能（Application Transmission Interface）統(tǒng)一TMIS數(shù)據(jù)傳輸格式；為應(yīng)用屏蔽MQ，盡可能地簡化用戶在數(shù)據(jù)傳輸過程中的調(diào)用接口，做到用戶只需填寫做什么、從哪發(fā)、發(fā)到哪、怎么發(fā)既可；通過對要傳輸數(shù)據(jù)源地址和目的地址的填寫，為實現(xiàn)TMIS數(shù)據(jù)自動轉(zhuǎn)發(fā)和分發(fā)打下了基礎(chǔ)；該軟件支持消息到消息的傳輸，結(jié)合不同應(yīng)用對接收消息的處理入庫模塊后，即完成了TMIS數(shù)據(jù)庫到庫的傳輸；除此之外，該軟件還支持文件到文件的傳輸、消息到文件的傳輸、文件到消息的傳輸?shù)?。?）可操作性：應(yīng)用系統(tǒng)在全路的實施過程