指令公用程式 (imqcmd) 可用於管理代理程式、連線服務、連線、實體目標、長期訂閱與作業事件。
所有 imqcmd 指令都必須包含子指令 (除了使用 -v 或 -h 選項以顯示產品版本資訊或用法說明以外)。此處會列出可能的子指令,還會在以下各節詳細地說明。在所有情況下,如果子指令接受代理程式位址 (-b 選項),而且未指定主機名稱和連接埠號,那麼會使用預設值 localhost 與 7676。
shutdown bkr |
關閉代理程式 |
restart bkr |
重新啟動代理程式 |
pause bkr |
暫停代理程式 |
resume bkr |
重新繼續代理程式 |
update bkr |
設定代理程式特性 |
reload cls |
重新載入叢集配置 |
query bkr |
列出代理程式特性值 |
metrics bkr |
顯示代理程式度量 |
pause svc |
暫停連線服務 |
resume svc |
重新繼續連線服務 |
update svc |
設定連線服務特性 |
list svc |
列出代理程式上可用的連線服務 |
query svc |
列出連線服務特性值 |
metrics svc |
顯示連線服務度量 |
list cxn |
列出代理程式上的連線 |
query cxn |
顯示連線資訊 |
create dst |
建立實體目標 |
destroy dst |
銷毀實體目標 |
pause dst |
暫停將訊息傳送給實體目標 |
resume dst |
重新繼續將訊息傳送給實體目標 |
update dst |
設定實體目標特性 |
purge dst |
清除來自實體目標的所有訊息 |
compact dst |
壓縮實體目標 |
list dst |
列出實體目標 |
query dst |
列出實體目標特性值 |
metrics dst |
顯示實體目標度量 |
destroy dur |
銷毀長期訂閱 |
purge dur |
清除長期訂閱的所有訊息 |
list dur |
列出主題的長期訂閱 |
commit txn |
確定作業事件 |
rollback txn |
回復作業事件 |
list txn |
列出代理程式追蹤的作業事件 |
query txn |
顯示作業事件資訊 |
要使用代理程式公用程式 (imqbrokerd) 才能啟動代理程式;無法使用指令公用程式啟動代理程式。啟動代理程式之後,就可以使用表 13–2 中列出的 imqcmd 子指令對該代理程式進行管理與控制。
表 13–2 用於代理程式管理的指令公用程式子指令
語法 |
說明 |
---|---|
shutdown bkr [-b hostName :portNumber] | |
restart bkr [-b hostName :portNumber] |
關閉代理程式,然後使用原來啟動時所指定的相同選項重新啟動該代理程式。 |
pause bkr [-b hostName :portNumber] |
如需更多資訊,請參閱暫停代理程式。 |
resume bkr [-b hostName :portNumber] | |
update bkr [-b hostName :portNumber] -o property1= value1 [ [-o property2 =value2] … ] |
設定代理程式特性 請參閱第 14 章, 代理程式特性參照,以取得代理程式特性的相關資訊。 |
reload cls |
強制更新所有永久性資訊以保持最新的狀態。 |
query bkr -b hostName :portNumber |
列出代理程式特性值 還會列出所有連線至叢集中指定代理程式的執行中代理程式。 |
metrics bkr [-b hostName :portNumber] [-m metricType] [-int interval] [-msp numSamples] |
顯示代理程式度量 -m 選項可指定要顯示的度量類型: ttl:傳入和傳出代理程式的訊息與封包 rts:代理程式的訊息與封包每秒傳入和傳出的速率 cxn:連線、虛擬記憶體堆疊與執行緒 預設值:ttl。 -int 選項可指定顯示度量的時間間隔 (以秒為單位)。預設值: 5。 -msp 選項可指定要顯示的範例數目。預設值:不限制 (無限)。 |
表 13–3 列出可管理連線服務的 imqcmd 子指令。
表 13–3 連線服務管理的指令公用程式子指令
語法 |
說明 |
---|---|
pause svc -n serviceName [-b hostName: portNumber] |
無法暫停 admin 連線服務。 |
resume svc -n serviceName [-b hostName: portNumber] | |
update svc -n serviceName [-b hostName: portNumber] -o property1= value1 [ [-o property2 =value2] … ] |
設定連線服務特性 請參閱連線特性,以取得連線服務特性的相關資訊。 |
list svc [-b hostName :portNumber] |
列出代理程式上可用的連線服務 |
query svc -n serviceName [-b hostName: portNumber] |
列出連線服務特性值 |
metrics svc -n serviceName [-b hostName: portNumber] [-m metricType] [-int interval] [-msp numSamples] |
顯示連線服務度量 -m 選項可指定要顯示的度量類型: ttl:利用指定的連線服務,傳入和傳出代理程式的訊息與封包 rts:利用指定的連線服務,代理程式的訊息與封包每秒傳入和傳出的速率 cxn:連線、虛擬記憶體堆疊與執行緒 預設值:ttl。 -int 選項可指定顯示度量的時間間隔 (以秒為單位)。預設值: 5。 -msp 選項可指定要顯示的範例數目。預設值:不限制 (無限)。 |
表 13–4 列出可管理連線的 imqcmd 子指令。
表 13–4 連線服務管理的指令公用程式子指令
語法 |
說明 |
---|---|
list cxn [-svn serviceName] [-b hostName: portNumber] |
列出指定連線服務在代理程式上的所有連線。如果未指定連線服務,則會列出所有連線。 |
query cxn -n connectionID [-b hostName: portNumber] |
表 13–5 列出可管理實體目標的 imqcmd 子指令。在所有情況下,- t (目標類型) 選項均可使用下列兩項值之一:
q:佇列目標
t:主題目標
語法 |
說明 |
---|---|
create dst -t destType -n destName [-o property1 =value1] [ [ -o property2 =value2] … ] |
建立實體目標 [不能在主代理程式暫時無法使用的代理程式叢集上執行此作業。] 目標名稱 destName 只能包含字母數字字元 (無空格),而且必須以字母字元或底線 (_) 或錢幣符號 ($) 開頭。而且開頭不能是 mq 字元。 |
destroy dst -t destType -n destName |
銷毀實體目標 此作業不適用於由系統建立的目標,例如停用的訊息佇列。 |
pause dst [-t destType -n destName] [-pst pauseType] |
暫停將訊息傳送給利用 - t 與 -n 選項指定的實體目標。如果未指定這些選項,就會暫停所有目標。 -pst 選項可指定要暫停的訊息傳送類型: CONSUMERS:暫停傳送給訊息用戶 PRODUCERS:暫停傳送給訊息產生器 ALL:暫停所有訊息傳送 預設值:ALL |
resume dst [-t destType -ndestName] |
重新繼續將訊息傳送給實體目標 重新繼續將訊息傳送給利用 - t 與 -n 選項指定的實體目標。如果未指定這些選項,就會重新繼續所有目標。 |
update dst -t destType -n destName -o property1= value1 [ [ -o property2 =value2] … ] |
請參閱第 15 章, 實體目標特性參照,以取得實體目標特性的相關資訊。 |
purge dst -t destType -n destName | |
compact dst [-t destType -n destName] |
壓縮由 -t 與 -n 選項所指定之實體目標的檔案式永久性資料存放區。如果未指定這些選項,就會壓縮所有目標。 必須在壓縮目標前暫停目標。 |
list dst [-t destType] [-tmp] |
列出實體目標 列出由 -t 選項指定的所有實體目標類型。如果未指定目標類型,就會列出佇列與主題目標。如果已指定 -tmp 選項,也會列出暫時目標。 |
query dst -t destType -n destName | |
metrics dst -t destType -n destName [-m metricType] [-int interval] [-msp numSamples] |
顯示實體目標度量 -m 選項可指定要顯示的度量類型: ttl:傳入和傳出目標以及常駐於記憶體中的訊息與封包。 rts:代理程式的訊息與封包每秒傳入和傳出的速率,以及其他速率資訊 con:與訊息用戶相關的度量 dsk:磁碟使用率 預設值:ttl。 -int 選項可指定顯示度量的時間間隔 (以秒為單位)。預設值: 5。 -msp 選項可指定要顯示的範例數目。預設值:不限制 (無限)。 |
表 13–6 列出可管理長期訂閱的 imqcmd 子指令。
表 13–6 用於長期訂閱管理的指令公用程式子指令
語法 |
說明 |
---|---|
destroy dur -c clientID -n subscriberName | |
purge dur -c clientID -n subscriberName | |
list dur -d topicName |
表 13–7 列出可管理作業事件的 imqcmd 子指令。
表 13–7 用於作業事件管理的指令公用程式子指令
語法 |
說明 |
---|---|
commit txn -n transactionID | |
rollback txn -n transactionID | |
list txn | |
query txn -n transactionID |
表 13–8 中列出的其他選項,可套用至 imqcmd 指令的任何子指令。
表 13–8 一般指令公用程式選項
選項 |
說明 |
---|---|
-secure | |
-u userName |
認證的使用者名稱 如果省略此選項,指令公用程式就會以互動方式提示您輸入。 |
-p password |
認證的密碼 [此選項已經停用而且會永遠移除。請省略密碼 (將會以互動方式提示使用者輸入密碼),或使用 -passfile 選項指定包含密碼的檔案。] |
-passfile path |
密碼檔案位置 如需更多資訊,請參閱密碼檔案。 |
-rtm timeoutInterval |
初始逾時時間間隔 (以秒為單位) 重試請求之前,指令公用程式等待代理程式回覆的初始時間長度。每次後續重試都會使用逾時時間間隔,而此間隔為此初始時間間隔的倍數。 預設值:10。 |
-rtr numRetries |
代理程式請求逾時之後的重試次數 預設值:5。 |
-javahome path |
預設運作方式:使用安裝在系統上或是隨附於 Message Queue 的執行階段。 |
-f |
執行動作而無需使用者確認 |
-s |
無訊息模式 (不顯示輸出) |
-v | |
-h | |
-H |
顯示詳細的用法說明,包括屬性清單與範例, |