IBM_MQ常用命令.doc

1. 隊列管理器1.1. 創(chuàng)建隊列管理器命令：crtmqm 示例：crtmqm -ld /var/mqm/log -lc -lf 16384 -lp 25 -ls 5 QMCIS參數(shù)說明：-ld 日志文件目錄-lc 使用循環(huán)日志-lf 日志文件頁大小-lp 主日志文件個數(shù)-ls 輔助日志文件個數(shù)QMCIS：隊列管理器名1.2. 啟動隊列管理器命令：strmqm 停止隊列管理器命令：endmqm -c|-w|-i|-p 參數(shù)說明：-c 受控關閉（或停頓關閉）。這是缺省值。 隊列管理器停止，但僅當所有應用程序已斷開連接后才停止。當前正在處理的任何 MQI 調(diào)用已完成。立即將控制權(quán)返回給您，并且不通知您隊列管理器是何時停止的。對通過服務器連接通道連接的任何客戶機應用程序的影響等效于以 QUIESCE 方式發(fā)出的 STOP CHANNEL 命令。-w 等待關閉。 此類型的關閉等效于受控關閉（除了僅當隊列管理器已停止后才將控制權(quán)返回給您之外）。當執(zhí)行關閉時，您將接收到消息：等待隊列管理器 qmName 結(jié)束。對通過服務器連接通道連接的任何客戶機應用程序的影響等效于以 QUIESCE 方式發(fā)出的 STOP CHANNEL 命令。-i 立即關閉。隊列管理器在完成所有當前正在處理的 MQI 調(diào)用后停止。任何在該命令發(fā)出后發(fā)出的 MQI 請求都將失敗。當隊列管理器再次啟動時，任何未完成的工作單元將回滾。 隊列管理器結(jié)束后返回控制權(quán)。對通過服務器連接通道連接的任何客戶機應用程序的影響等效于以 FORCE 方式發(fā)出的 STOP CHANNEL 命令。-p 搶先關閉。 僅在意外情況下使用此類型的關閉。例如，當隊列管理器在常規(guī) endmqm 命令下未停止。隊列管理器可以停止而不等待應用程序斷開連接或 MQI 調(diào)用完成。這可能會產(chǎn)生 WebSphere MQ 應用程序的不可預測的結(jié)果。關閉方式設置為立即關閉。如果隊列管理器稍后未停止，關閉方式將升級，且終止所有剩余的的隊列管理器進程。對通過服務器連接通道連接的任何客戶機應用程等效于以 TERMINATE 方式發(fā)出的 STOP CHANNEL 命令。1.3. 刪除隊列管理器命令：dltmqm1.4. 顯示隊列管理器啟動狀態(tài)命令：dspmq命令結(jié)果顯示示例：QMNAME(Test) STATUS(正在運行)QMNAME(Test2) STATUS(已正常結(jié)束)2. 管理本地MQ對象使用 MQSC 命令執(zhí)行本地管理任務使用MQSC命令執(zhí)行定義或修改隊列、通道等操作。MQSC命令可以有以下兩種使用方式：l 交互地使用 MQSC 命令：runmqsc qmgrNamel 從文本文件運行 MQSC 命令：runmqsc qmgrName myprog.out命名 WebSphere MQ 對象的規(guī)則：WebSphere MQ 認證信息、通道、客戶機通道、偵聽器、名稱列表、進程、隊列、服務和存儲類對象存在于各自獨立的對象名稱空間中，因此，每個不同類型的對象都可以有相同的名稱。但是，同一個名稱空間中的對象不能與任何其它的對象同名。（例如，本地隊列不能和模型隊列有相同的名稱。）WebSphere MQ 中的名稱都區(qū)分大小寫；但是，您應該記住不包含在引號中的小寫字符將轉(zhuǎn)換為大寫。顯示或修改隊列管理器屬性display qmgr (display可簡寫為dis)示例：alter qmgr CCSID(819)#修改字符集def ql(DEADQ) defpsist(yes) maxdepth(20000) replacealter qmgr deadq(DEADQ)#設置死信隊列為DEADQ2.1. 隊列2.1.1. 定義本地隊列示例def ql(FROMCCPC_1) maxdepth(10000) defpsist(yes) replace參數(shù)說明：l ql(FROMCCPC_1)： 隊列本地名稱l maxdepth：隊列上允許的最大消息數(shù)；l defpsist：隊列中消息持久性默認值。NO 該隊列上的消息在隊列管理器重新啟動時丟失YES 該隊列上的消息在隊列管理器重新啟動時保存了下來。關于消息在隊列中的保存時間：消息在隊列的保存時間與三個設置有關：隊列defpsist屬性、消息Persistence持久性屬性和消息Expiry消息到期時間屬性，其中隊列defpsist屬性是在創(chuàng)建隊列時設置，消息Persistence和Expiry屬性是應用程序往隊列放入消息時指定。消息本身的Persistence值優(yōu)先于隊列defpsist值。Expiry指消息到期時間，即經(jīng)過指定的時間后，消息如果還沒被取走，此消息將過期（無效）。消息過期后，可能會自動從隊列中刪除（取決于不同操作系統(tǒng)的MQ實現(xiàn)）。對于非持久性消息，即使Expiry設為永不過期，重啟隊列管理器時，消息也將丟失。2.1.2. 定義遠程隊列示例def qr(TOCCPC_1) rname(5819_1) rqmname(QMC5819) xmitq(QMGF) defpsist(yes) replace參數(shù)說明：l qr(TOCCPC_1)：隊列本地名稱，名字可任意??；l rname(5819_1)：遠程隊列名，必須與遠程隊列管理器中的本地隊列名相同；l rqmname(QMC5819)：遠程隊列管理器名，必須與遠程隊列管理器名相同；l xmitq(QMGF)：本地傳輸隊列名稱。2.1.3. 定義傳輸隊列示例def ql(QMGF) usage(XMITQ) defpsist(YES) maxdepth(50000) trigger trigtype(FIRST) trigdata(999581030604.5819) initq(SYSTEM.CHANNEL.INITQ) replace參數(shù)說明：l ql (QMGF)：隊列本地名稱，名字可任意??；l usage(XMITQ)：指定此本地隊列為傳輸隊列，參數(shù)值固定填“XMITQ”；l trigger：啟動觸發(fā)（相應的，NOTRIGGER為禁用觸發(fā)）l trigtype(FIRST) ：觸發(fā)方式，建議值為“FIRST”，即第一條消息觸發(fā)；l trigdata(999581030604.5819)：觸發(fā)數(shù)據(jù)，值為傳輸隊列將使用的發(fā)送通道名；l initq(SYSTEM.CHANNEL.INITQ)：觸發(fā)隊列，固定填“SYSTEM.CHANNEL.INITQ”。觸發(fā)器在此的作用是當傳輸隊列接收到第一條消息時，將觸發(fā)啟動指定的發(fā)送通道。2.1.4. 查看隊列dis ql(qname) all顯示隊列所有屬性dis ql(qname) curdepth 顯示隊列當前深度，即當前隊列中存放的消息數(shù)dis qs(qname) type(queue) all顯示與隊列相關的狀態(tài)信息dis qs(qname) type(handle) all顯示與訪問隊列的句柄相關的狀態(tài)信息2.1.5. 刪除隊列delete ql(qname)2.1.6. 刪除隊列中的消息clear ql(qname)注：刪除隊列中的消息時出錯時處理嘗試執(zhí)行命令RESOLVE CHANNEL(channel_name) ACTION( COMMIT )后，再執(zhí)行clear ql命令。2.2. 通道2.2.1. 定義接收通道def chl(999581000107.5819) chltype(rcvr) trptype(tcp) replace參數(shù)描述：l chl(999581000107.5819)：接收通道名稱，必須與遠程隊列管理器中的發(fā)送對列名稱相同。推薦的命名規(guī)則為 “遠程隊列管理器名.本地隊列管理器名”；l chltype(rcvr)：指定通道為類型，值固定為“rcvr”；l trptype(tcp)：通訊協(xié)議，除非特別指明，一般采用“tcp”協(xié)議。2.2.2. 定義發(fā)送通道def chl(5819.999581000107) chltype(SDR) discint(0) conname(10.2.106.106(1417) xmitq(QMCIS) trptype(tcp) replace2.2.3. 定義服務器連接通道def chl() chltype() replace2.2.4. 刪除通道Delete chl(channel name)2.2.5. 查看通道狀態(tài)dis chs(channel name)通道的當前狀態(tài)，它可以是正在啟動、正在綁定、正在初始化、正在運行、正在停止、正在重試、已暫停、已停止、正在請求和通道狀態(tài)未找到。正常運行時，通道狀態(tài)為“正在運行”；關閉通道時，通道狀態(tài)為“已停止”；如果通道狀態(tài)長時間處于“正在綁定”（binding）、“正在重試”（retrying），則表明通道不正常，需要人工介入。這時可查看隊列管理器日志文件，日志文件中一般會提供異常原因。關于“通道狀態(tài)未找到”：此狀態(tài)值僅表示當前沒有建立到此通道的連接，并不能表示通道是否正常。2.2.6. 啟動通道Start chl(channel name)2.2.7. 關閉通道Stop chl(channel name)2.2.8. 重置通道reset chl(channel name)2.3. 監(jiān)聽器定義監(jiān)聽器def listener(QMC5819) TRPTYPE(TCP) PORT(1417) CONTROL(STARTONLY) BACKLOG(0) replace參數(shù)描述：l listener(QMC5819)：監(jiān)聽器名，名稱可任意?。籰 TRPTYPE(TCP)：通訊協(xié)議類型；l PORT（1417）：服務監(jiān)聽端口l CONTROL(string）指定如何啟動和停止偵聽器： MANUAL 不會自動啟動或自動停止偵聽器。通過使用 START LISTENER 命令和 STOP LISTENER 命令來控制它。這是缺省值。 QMGR 當隊列管理器啟動和停止時，同時啟動和停止被定義的偵聽器。 STARTONLY 當隊列管理器啟動時，同時啟動偵聽器，但當隊列管理器停止時，不請求停止偵聽器。 2.3.1. 啟動監(jiān)聽器start listener(QMC5819)2.3.2. 關閉監(jiān)聽器stop listener(QMC5819)2.3.3. 查看監(jiān)聽器狀態(tài)dis lsstatus(LISTENER.TCP) all (QMC5819) all3. WebSphere MQ 配置文件 mqs.iniWebSphere MQ 配置文件 mqs.ini 包含和節(jié)點上所有隊列管理器都相關的信息。它在安裝期間自動創(chuàng)建。WebSphere MQ for UNIX 系統(tǒng)的 mqs.ini 文件在 /var/mqm 目錄中。它包含： 隊列管理器的名稱 缺省隊列管理器的名稱 和每個文件關聯(lián)的文件位置圖 9 顯示 WebSphere MQ 配置文件的示例：圖 9. UNIX(R) 系統(tǒng)的 WebSphere MQ 配置文件示例 #*#* Module Name: mqs.ini *#* Type : WebSphere MQ Machine-wide Configuration File *#* Function : Define WebSphere MQ resources for an entire machine *#*#* Notes : *#* 1) This is the installation time default configuration *#* *#*#AllQueueManagers:#*#* The path to the qmgrs directory, below which queue manager data *#* is stored *#*#DefaultPrefix=/var/mqmLogDefaults: LogPrimaryFiles=3 LogSecondaryFiles=2 LogFilePages=1024 LogType=CIRCULAR LogBufferPages=0 LogDefaultPath=/var/mqm/logQueueManager: Name=saturn.queue.manager Prefix=/var/mqm Directory=saturn!queue!managerQueueManager: Name=pluto.queue.manager Prefix=/var/mqm Directory=pluto!queue!managerDefaultQueueManager: Name=saturn.queue.manager ApiExitTemplate: Name=OurPayrollQueueAuditor Sequence=2 Function=EntryPoint Module=/usr/ABC/auditor Data=123 ApiExitCommon: Name=MQPoliceman Sequence=1 Function=EntryPoint Module=/usr/MQPolice/tmqp Data=CheckEverything4. 隊列管理器配置文件 qm.ini隊列管理器配置文件（qm.ini）包含特定隊列管理器的相關信息。每個隊列管理器都有一個隊列管理器配置文件。創(chuàng)建和 qm.ini 文件關聯(lián)的隊列管理器時，將自動創(chuàng)建此文件。qm.ini 文件保存在隊列管理器占用的目錄樹的根中。例如，隊列管理器 QMNAME 的配置文件的路徑和名稱是：/var/mqm/qmgrs/QMNAME/qm.ini隊列管理器名稱可長達 48 個字符的長度。但是，這并不保證此名稱是有效的或唯一的。因此，目錄名稱是基于隊列管理器名稱生成的。這個過程也稱為名稱變換。有關描述，請參閱理解 WebSphere MQ 文件名。圖 10 顯示在 WebSphere MQ for UNIX 系統(tǒng)中如何在隊列管理器配置文件中排列屬性的組。圖 10. WebSphere MQ for UNIX 系統(tǒng)的隊列管理器配置文件示例 #* Module Name: qm.ini *#* Type : WebSphere MQ queue manager configuration file *# Function : Define the configuration of a single queue manager *#* *#*#* Notes : *#* 1) This file defines the configuration of the queue manager *#* *#*#ExitPath: ExitsDefaultPath=/var/mqm/exits ExitsDefaultPath64=/var/mqm/exits64 Service: Name=AuthorizationService EntryPoints=13 ServiceComponent: Service=AuthorizationService Name=MQSeries.UNIX.auth.service Module=/opt/mqm/bin/amqzfu 1 ComponentDataSize=0Log: LogPrimaryFiles=3 LogSecondaryFiles=2 LogFilePages=1024 LogType=CIRCULAR LogBufferPages=0 LogPath=/var/mqm/log/saturn!queue!manager/XAResourceManager: Name=DB2 Resource Manager Bank SwitchFile=/usr/bin/db2swit XAOpenString=MQBankDB XACloseString= ThreadOfControl=THREADChannels: 2 MaxChannels=20 MaxActiveChannels=100 MQIBindType=STANDARDTCP: KeepAlive = YesQMErrorLog: ErrorLogSize=262144 ExcludeMessage=7234 SuppressMessage=9001,9002,9202 SuppressInterval=30 ApiExitLocal: Name=ClientApplicationAPIchecker Sequence=3 Function=EntryPoint Module=/usr/Dev/ClientAppChecker Data=9.20.176.20 5. 5. MQ日志5.1.1. 隊列管理器日志從 WebSphere MQ 資源管理器使用日志隊列管理器屬性頁，或 qm.ini 文件中的 Log 節(jié)來指定與此隊列管理器上的日志記錄相關的信息。缺省情況下，這些設置從為隊列管理器的缺省日志設置指定的設置繼承（在WebSphere MQ 的日志缺省中描述）。如果您要以不同的方法配置此隊列管理器，則僅更改這些設置。有關計算日志大小的信息，請參閱計算日志的大小。注：以下參數(shù)列表中給出的限制由 WebSphere MQ 設置。操作系統(tǒng)限制可能減少最大可能的日志大小。LogPrimaryFiles=3|2-254 (Windows)|2-510 (UNIX 系統(tǒng)) 創(chuàng)建隊列管理器時分配的日志文件。 主日志文件的最小數(shù)目是 2，最大數(shù)目在 Windows 上是 254，在 UNIX 系統(tǒng)上是 510。缺省值是 3。主日志文件和輔助日志文件的總數(shù)在 Windows 不能超過 255，在 UNIX 系統(tǒng)上不能超過 511，并且不能小于 3。創(chuàng)建或啟動隊列管理器時檢查此值。創(chuàng)建隊列管理器后，您可更改它。但是，在重新啟動隊列管理器前值的更改不是有效的，不會立即產(chǎn)生作用。LogSecondaryFiles=2|1-253 (Windows)|1-509 (UNIX 系統(tǒng)) 耗盡主文件時分配的日志文件。 輔助日志文件的最小數(shù)目是 1，在 Windows 上最大數(shù)目是 253，在 UNIX 系統(tǒng)上最大數(shù)目是 509。缺省數(shù)目是 2。主日志文件和輔助日志文件的總數(shù)在 Windows 不能超過 255，在 UNIX 系統(tǒng)上不能超過 511，并且不能小于 3。啟動隊列管理器時檢查此值。您可更改此值，但是在重新啟動隊列管理器前更改不會有效，而且然后也不會立即發(fā)生作用。LogFilePages=number 日志數(shù)據(jù)保存在稱為日志文件的一系列文件中。日志文件大小以 4KB 頁為單位指定。 在 WebSphere MQ for UNIX 系統(tǒng)中，日志文件頁數(shù)的缺省數(shù)是 1024，日志文件大小是 4MB。日志文件的最小頁數(shù)是 64，最大頁數(shù)是 65535。在 WebSphere MQ for Windows 中，日志文件頁數(shù)的缺省值是 256，日志文件大小是 1MB。日志文件的最小頁數(shù)是 32，最大頁數(shù)是 65535。注：創(chuàng)建隊列管理器期間指定的日志文件大小不能因為隊列管理器而更改。LogType=CIRCULAR|LINEAR 隊列管理器使用的日志記錄類型。一旦創(chuàng)建了隊列管理器，您就無法更改將使用的日志記錄的類型。請參閱WebSphere MQ 的日志缺省中的 LogType 屬性的描述，以獲取關于創(chuàng)建具有您需要的日志記錄類型的隊列管理器的信息。 CIRCULAR 使用日志回滾系統(tǒng)停止時在處理中的事務來啟動重新啟動恢復。 請參閱循環(huán)日志記錄 以獲取更全面的循環(huán)日志記錄的說明。LINEAR 對于重新啟動恢復和介質(zhì)或正向恢復（通過重放日志內(nèi)容來創(chuàng)建丟失或損壞的數(shù)據(jù)）。 請參閱線性日志記錄以獲取更全面的線性日志記錄的說明。LogBufferPages=0|0-4096 分配給緩沖區(qū)記錄進行寫操作的內(nèi)存數(shù)量，以 4 KB 頁為單位指定緩沖區(qū)大小。 緩沖區(qū)頁的最小數(shù)量是 18，最大數(shù)量是 4096。緩沖區(qū)越大，其吞吐量越高，尤其是那些較大的消息。如果您指定 0（缺省值），則隊列管理器選擇此大小。在 WebSphere MQ V6.0 中，這是 128（512 KB）。如果您指定一個 1 到 17 之間的數(shù)，則隊列管理器缺省是 18（72 KB）。如果您指定一個 18 和 4096 之間的數(shù)，則隊列管理器使用指定的用于設置內(nèi)存分配的數(shù)。創(chuàng)建或啟動隊列管理器時檢查此值，在這兩個時候值可能會增加或減少。但是，對此值的更改在重新啟動隊列管理器之后才會有效。LogPath=directory_name 隊列管理器的日志文件所在的目錄。該目錄必須存在于隊列管理器能寫的本地設備上，更好的情況是該目錄與消息隊列在不同的驅(qū)動器上。指定不同的驅(qū)動器能在系統(tǒng)發(fā)生故障的情況下提供更好的保護。 缺省值是： 在 WebSphere MQ for Windows 中是 C:Program FilesIBMWebSphere MQlog。 在 WebSphere MQ for UNIX 系統(tǒng)中是 /var/mqm/log。您可以使用 -ld 標志在 crtmqm 命令中指定目錄的名稱。創(chuàng)建隊列管理器時，在隊列管理器目錄下還會創(chuàng)建一個目錄，此目錄用于保存日志文件。這個目錄的名稱基于隊列管理器名稱。這確保日志文件路徑是唯一的，并確保它符合目錄名稱長度的任何限制。如果您沒有在 crtmqm 命令中指定 -ld，則使用 LogDefaultPath 屬性的值。在 WebSphere MQ for UNIX 系統(tǒng)中，用戶標識 mqm 和組 mqm 必須具有對日志文件的全部權(quán)限。如果您更改這些文件的位置，則必須自己提供這些權(quán)限。如果日志文件位于隨此產(chǎn)品一起提供的缺省位置，則這不是必需的。LogWriteIntegrity=SingleWrite|DoubleWrite|TripleWrite 記錄器使用的用于可靠地寫日志記錄的方法。 SingleWrite 某些硬件保證當寫操作寫一個頁并因任何原因失敗時，對緩沖區(qū)中相同頁的后續(xù)讀操作會導致緩沖區(qū)中的每個字節(jié)出現(xiàn)下列兩種情況： 是與寫操作之前相同的字節(jié)，或 是在寫操作中已寫的字節(jié)在此類硬件上（例如，啟用 ssa 寫高速緩存），因為該硬件可以保證完全的寫完整性，所以記錄器在單個寫操作中寫日志記錄是很安全的。此方法提供最高級別的性能。 DoubleWrite DoubleWrite 方法是在 WebSphere MQ V5.2 中使用的缺省方法，且只可用于向后兼容性的用途。 TripleWrite 這是缺省方法。在確定寫完整性不可用的硬件中，使用 TripleWrite 方法寫入日志記錄，因為 TripleWrite 方法提供完整的寫完整性。 5.1.2. 計算日志的大小確定隊列管理器應該使用循環(huán)日志記錄還是線性日志記錄后，您需要估計該隊列管理器需要的日志大小。日志大小是由以下日志配置參數(shù)確定的：LogFilePages 每個主日志文件和輔助日志文件的大?。ㄒ?4K 頁為單位） LogPrimaryFiles 預分配的主日志文件數(shù) LogSecondaryFiles 可創(chuàng)建的輔助日志文件數(shù)（主日志文件滿時使用） 表 17顯示隊列管理器為各種操作記錄的數(shù)據(jù)量。大多數(shù)隊列管理器操作需要的日志空間量都很少。但是，當持久消息放入隊列時，所有消息數(shù)據(jù)都必須寫入日志，以便能恢復此消息。通常，日志大小取決于隊列管理器需要處理的持久消息的數(shù)量和大小。表 17. 日志開銷大?。ㄋ兄刀际墙频模┎僮鞔笮》湃氤志孟?50 字節(jié) + 消息長度 如果是大型消息，則分隔成 15700 字節(jié)的段，每個段可以有 300 字節(jié)的開銷。取出消息260 字節(jié)同步點，落實750 字節(jié)同步點，回滾1000 字節(jié) + 12 字節(jié)（要回滾的每個取出或放入操作）創(chuàng)建對象1500 字節(jié)刪除對象300 字節(jié)改變屬性1024 字節(jié)記錄介質(zhì)映像800 字節(jié) + 映像 映像分隔成 260 000 字節(jié)的段，每個段有 300 字節(jié)開銷。檢查點750 字節(jié) + 200 字節(jié)（每個活動的工作單元） 可以為任何未落實的放入或取出（由于性能原因而進行了緩存）記錄其它數(shù)據(jù)。注：1. 每當隊列管理器啟動時，您都可以更改主日志文件和輔助日志文件的數(shù)目。 2. 您無法更改日志文件大??；必須在創(chuàng)建隊列管理器前確定它。 3. 主日志文件的數(shù)量和日志文件大小確定創(chuàng)建隊列管理器時預分配的日志空間的量。 4. 主日志文件和輔助日志文件的總數(shù)在 UNIX 系統(tǒng)上不能超過 511，在 Windows 上不能超過 255，當存在長期運行事務時，這會限制隊列管理器可用于重新啟動恢復的最大日志空間量。隊列管理器用于介質(zhì)恢復所需的日志空間量不共享此極限。 5. 使用循環(huán)日志記錄時，隊列管理器復用主日志空間。這意味著隊列管理器的日志可以比您估計的隊列管理器需要記錄的數(shù)據(jù)量要小。日志文件滿時，隊列管理器將分配一個輔助日志文件（最多到極限值），并且序列中的下一個主日志文件不可用。 6. 主日志文件可用于檢查點期間的復用。由于日志空間量的減少，因此使用檢查點前，隊列管理器會考慮主日志和輔助日志空間。 如果您不定義比輔助日志文件更多的主日志文件，則隊列管理器在采用檢查點前可以分配輔助日志文件。這使得主日志文件可以復用。5.1.3. 錯誤日志W(wǎng)ebSphere MQ 使用了許多錯誤日志來捕獲相關消息，這些消息與 WebSphere MQ 自身的操作、您啟動的任何隊列管理器以及來自正在使用的通道的錯誤數(shù)據(jù)有關。錯誤日志的位置取決于隊列管理器名稱是否是已知的，以及錯誤是否與客戶機有關。 如果隊列管理器名稱是已知的，則錯誤日志的位置如表 18 中所示。 表 18. 隊列管理器的錯誤日志目錄平臺目錄UNIX 系統(tǒng)/var/mqm/qmgrs/qmname/errorsWindows 系統(tǒng)c:Program FilesIBMWebSphere MQqmgrsqmnameerrors 如果隊列管理器名稱是未知的，則錯誤日志的位置如表 19 中所示。 表 19. 系統(tǒng)錯誤日志目錄平臺目錄UNIX 系統(tǒng)/var/mqm/errorsWindows 系統(tǒng)c:Program FilesIBMWebSphere MQerrors 如果是客戶機應用程序發(fā)生了錯誤，則客戶機上錯誤日志的位置如表 20 中所示。 表 20. 客戶機錯誤日志目錄平臺目錄UNIX 系統(tǒng)/var/mqm/errorsWindows 系統(tǒng)c:Program FilesIBMWebSphere MQ Clienterrors在 WebSphere MQ for Windows 中，對錯誤的指示也同樣添加到應用程序日志中，可以用與 Windows 系統(tǒng)一起提供的“事件查看器”應用程序來檢查應用程序日志。在安裝期間，將在 UNIX 系統(tǒng)上的 /var/mqm 文件路徑中，以及 Windows 系統(tǒng)上的 IBMWebSphere MQ 文件路徑中創(chuàng)建 errors 子目錄。errors 子目錄最多可以包含 3 個錯誤日志文件，它們是： AMQERR01.LOG AMQERR02.LOG AMQERR03.LOG在創(chuàng)建了隊列管理器后，隊列管理器將在需要時創(chuàng)建 3 個隊列管理器錯誤日志文件。這些文件的名稱與它們在系統(tǒng)錯誤日志目錄中的名稱一樣，即 AMQERR01、AMQERR02 和 AMQERR03，并且每個文件的缺省容量都是 256 KB?？蓮?WebSphere MQ 資源管理器中的擴展隊列管理器屬性頁，或 qm.ini 文件中的 QMErrorLog 節(jié)來更改容量。在 UNIX 系統(tǒng)上，這些文件位于 /var/mqm/qmgrs/qmname 文件路徑的 errors 子目錄中，在 Windows 系統(tǒng)上，這些文件位于 IBMWebSphere MQqmgrsqmnameerrors 文件路徑中。錯誤消息生成后將被放在 AMQERR01 中。AMQERR01 大于 256 KB 時，將被復制到 AMQERR02 中。在此復制前，AMQERR02 被復制到 AMQERR03.LOG 中。而 AMQERR03 中以前的內(nèi)容（如果有的話）將廢棄。這樣，最新的錯誤消息總是放在 AMQERR01 中，而其它文件則用于保存錯誤消息的歷史。所有與通道相關的消息也將放在相應隊列管理器的錯誤文件中，除非該隊列管理器不可用或它的名稱是未知的，此時，與通道相關的消息將放在系統(tǒng)錯誤日志目錄中。要檢查任何錯誤日志文件的內(nèi)容，請使用常用的系統(tǒng)編輯器。早期的錯誤還存在這些錯誤日志還沒有建立就發(fā)生錯誤的特殊情況。WebSphere MQ 嘗試在錯誤日志中記錄任何這樣的錯誤。日志的位置取決于建立了多少隊列管理器。如果由于損壞了配置文件，例如，不能確定位置信息，則將錯誤記錄到根目錄（/var/mqm 或 C:Program FilesIBMWebSphere MQ）中的在安裝期間創(chuàng)建的 errors 目錄中。如果 WebSphere MQ 可以讀取其配置信息，并且可以訪問 Default Prefix 的值，則錯誤記錄在由 Default Prefix 屬性確定的目錄的 errors 子目錄中。例如，如果缺省前綴為 C:Program FilesIBMWebSphere MQ，則錯誤在 C:Program FilesIBMWebSphere MQerrors 中記錄。要獲取有關配置文件的更多信息，請參閱配置 WebSphere MQ。注：在 Windows 注冊表中的錯誤由啟動隊列管理器時的消息通知的。錯誤日志示例圖 23 顯示了從 WebSphere MQ 錯誤日志抽取的內(nèi)容：圖 23. WebSphere MQ 錯誤日志樣本 17/11/2004 10:32:29 進程（2132.1） 用戶（USER_1） 程序（runmqchi.exe）AMQ9542: 隊列管理器正在結(jié)束。說明：由于隊列管理器已停頓，所以該程序?qū)⒔Y(jié)束。操作：無。6. 測試常用指令測試1 本地通道測試1、使用mqadmin用戶登錄2、執(zhí)行crtmqm -q TEST_QM，建立測試用的消息管理器。3、執(zhí)行strmqm TEST_QM，啟動測試用的消息管理器。4、執(zhí)行runmqsc TEST_QM5、輸入define ql(DATA)，回車，建立本地隊列DATA6、輸入end回車至此，本地測試通道搭建完成，下面進行測試。1、執(zhí)行amqsput DATA TEST_QM2、隨便輸入一些內(nèi)容，一行為一條消息，可輸入多條。3、輸入完畢連續(xù)按兩次回車退出。4、執(zhí)行amqsget DATA TEST_QM，看看能否收到剛才輸入的消息，如果能收到，證明MQ本地通道是正常的。如果收不到，則MQ安裝有問題。測試2 遠程通道測試如果測試1通過，繼續(xù)進行遠程通道測試。1、執(zhí)行runmqsc TEST_QM2、輸入define chl(TO.TEST) chltype(RCVR) trptype(tcp)，創(chuàng)建接收方通道。3、輸入end并回車。4、執(zhí)行crtmqm TEST_RQM，建立模擬的遠程通道。5、執(zhí)行strmqm TEST_RQM6、執(zhí)行runmqsc TEST_RQM7、輸入define ql(TEST) usage(xmitq)8、輸入define qr(REMOTE.DATA) rname(DATA) rqmname(TEST_QM) xmitq(TEST)9、輸入define chl(TO.TEST) chltype(sdr) conname(127.0.0.1(1111) xmitq(TEST) trptype(tcp)，創(chuàng)建發(fā)送方通道。10、輸入end11、執(zhí)行runmqlsr -t tcp -m TEST_QM -p 1111，啟動接收方的監(jiān)聽。12、新打開一個telnet會話，用mqadmin登錄，執(zhí)行runmqsc TEST_RQM13、輸入start chl(TO.TEST)14、輸入end至此，模擬的遠程測試通道建立完成，以下進行測試。1、執(zhí)行amqsput REMOTE.DATA TEST_RQM2、隨便輸入一些內(nèi)容，一行為一條消息，可輸入多條。3、輸入完畢連續(xù)按兩次回車退出。4、執(zhí)行amqsget DATA TEST_QM，看看能否收到剛才輸入的消息，如果能收到，證明MQ本地通道是正常的。如果收不到，則MQ安裝有問題。刪除測試1、執(zhí)行endmqm -p TEST_RQM2、執(zhí)行endmqm -p TEST_QM3、執(zhí)行dltmqm TEST_RQM4、執(zhí)行dltmqm TEST_QMMQ中將消息發(fā)送至遠程隊列的配置摘自MQ資源管理器幫助文檔V7在開始學習本教程之前，您需要從系統(tǒng)管理員處了解標識網(wǎng)絡上接收機器的名稱：IP地址、MQ的端口號、隊列管理器、接收（遠程機器）或者是發(fā)送的隊列（本地機器）名稱。消息傳遞如圖示：本教程介紹了如何設置一臺計算機上的隊列管理器QM_ORANGE與另一臺計算機上的隊列管理器QM_APPLE之間的消息傳遞。在第一臺計算機上創(chuàng)建的消息被傳遞到第二臺計算機上的隊列Q1（此隊列被稱為遠程隊列）。要點： 在本教程中，您將使用創(chuàng)建了隊列管理器QM_APPLE和本地隊列Q1的機器作為接收機器。您將在發(fā)送機器上設置隊列管理器和隊列（遠程隊列定義和傳輸隊列）。然后定義消息通道。最后，您將把測試消息放入發(fā)送機器，并從接收機器上的隊列獲取該消息。完成本教程后，您應該基本了解如何使用遠程隊列定義來設置和使用WebSphereMQ消息傳遞。一、在發(fā)送機器上創(chuàng)建隊列管理器二、在發(fā)送隊列管理器上創(chuàng)建隊列三、創(chuàng)建消息通道四、將測試消息放入隊列五、驗證是否已發(fā)送測試消息一、在發(fā)送機器上創(chuàng)建隊列管理器在發(fā)送機器上使用WebSphere MQ資源管理器創(chuàng)建隊列管理器無法遠程完成此過程。必須在發(fā)送機器上本地完成此過程。1. 啟動WebSphere MQ資源管理器。2. 在導航器視圖中，右鍵單擊隊列管理器文件夾，然后單擊新建隊列管理器 此時會打開創(chuàng)建隊列管理器向?qū)А?. 在隊列管理器名稱字段中，輸入QM_ORANGE。4. 選中設置為缺省隊列管理器復選框。5. 單擊下一步兩次以轉(zhuǎn)至向?qū)У牟襟E3。6. 確保選中啟動隊列管理器復選框。7. 確保選中自動啟動隊列管理器復選框。8. 單擊下一步以轉(zhuǎn)至向?qū)У牟襟E4。9. 確保選中創(chuàng)建配置用于TCP/IP的偵聽器復選框。10. 如果完成按鈕不可用，那么在偵聽端口號字段中輸入另一個端口號。 如果當前值為1414，那么嘗試輸入1415或1416。11. 單擊完成。WebSphere MQ資源管理器的導航器視圖中的隊列管理器文件夾中會顯示表示此隊列管理器的圖標，并且在您創(chuàng)建隊列管理器后，該隊列管理器會自動開始運行。使用MQSC創(chuàng)建發(fā)送隊列管理器在發(fā)送機器上打開命令提示符，然后按照以下步驟操作：1. 通過輸入以下命令來創(chuàng)建名為QM_ORANGE的缺省隊列管理器：crtmqm -q QM_ORANGE此時會顯示消息，告訴您已經(jīng)創(chuàng)建了隊列和缺省WebSphere MQ對象。1. 通過輸入以下命令來啟動此隊列管理器：strmqm此時會顯示一條消息，告訴您何時啟動了該隊列管理器。1. 現(xiàn)在，您必須通過輸入以下命令來創(chuàng)建偵聽器：runmqlsr -m QM_APPLE -t TCP -p (port number)注： 如果未使用-p參數(shù)指定任何端口，那么使用缺省端口1414，但請注意，不能對發(fā)送方和接收方使用相同的端口號，因此，如果其中一個為1414，那么另一個就應該是1415。您現(xiàn)在已經(jīng)創(chuàng)建了發(fā)送隊列管理器。下一個任務是在此隊列管理器上創(chuàng)建隊列。二、在發(fā)送隊列管理器上創(chuàng)建隊列使用WebSphere MQ資源管理器在發(fā)送隊列管理器上創(chuàng)建隊列在發(fā)送隊列管理器上：1. 在導航器視圖中，展開隊列管理器文件夾。2. 展開隊列管理器QM_ORANGE。3. 右鍵單擊隊列文件夾，然后單擊新建遠程隊列定義.此時會打開新建遠程隊列定義向?qū)А?. 在名稱字段中，輸入Q1。5. 在遠程隊列字段中，輸入Q1。 【注：這里新建的遠程隊列的名稱，一定要和遠程機器上的隊列名稱相同，否則消息會發(fā)出去，但是遠程機器的隊列里面收不到消息，如上文提到的的Q1與Q1，或者是如下圖的testQ與testQ：】6. 在遠程隊列管理器字段中，輸入QM_APPLE。7. 在傳輸隊列字段中，輸入QM_APPLE。8. 單擊完成。 您現(xiàn)在已經(jīng)創(chuàng)建了遠程隊列定義。9. 單擊QM_ORANGE隊列管理器。10. 右鍵單擊隊列文件夾，然后單擊新建本地隊列 此時會打開新建本地隊列向?qū)А?1. 在名稱字段中，輸入QM_APPLE。12. 在用途字段中，選擇傳輸。13. 單擊完成。 您現(xiàn)在已經(jīng)在本地機器上創(chuàng)建了傳輸隊列。內(nèi)容視圖中將會顯示新隊列Q1和QM_APPLE。如果內(nèi)容視圖中未顯示這些隊列，請單擊位于內(nèi)容視圖頂部的“刷新”按鈕。使用MQSC來在發(fā)送隊列管理器上創(chuàng)建隊列在發(fā)送機器上打開命令提示符，然后按照以下步驟操作：1. 通過輸入以下命令來啟動MQSC：runmqsc此時會顯示一條消息，告訴您MQSC會話已啟