IBM_MQ常用命令.doc

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