Sun Java System Message Queue 3.7 UR1 管理指南

指令公用程式

指令公用程式 (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：主題目標

表 13–5 用於實體目標管理的指令公用程式子指令


語法	說明
`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`	透過 `ssladmin` 連線服務安全連線至代理程式
`-u` `userName`	認證的使用者名稱如果省略此選項，指令公用程式就會以互動方式提示您輸入。
`-p` `password`	認證的密碼 [此選項已經停用而且會永遠移除。請省略密碼 (將會以互動方式提示使用者輸入密碼)，或使用 `-passfile` 選項指定包含密碼的檔案。]
`-passfile` `path`	密碼檔案位置如需更多資訊，請參閱密碼檔案。
`-rtm` `timeoutInterval`	初始逾時時間間隔 (以秒為單位) 重試請求之前，指令公用程式等待代理程式回覆的初始時間長度。每次後續重試都會使用逾時時間間隔，而此間隔為此初始時間間隔的倍數。預設值：`10`。
`-rtr` `numRetries`	代理程式請求逾時之後的重試次數預設值：`5`。
`-javahome` `path`	替代 Java 執行階段的位置預設運作方式：使用安裝在系統上或是隨附於 Message Queue 的執行階段。
`-f`	執行動作而無需使用者確認
`-s`	無訊息模式 (不顯示輸出)
`-v`	顯示版本資訊 [會忽略指令行上指定的任何其他選項。] ^, [不需要使用者名稱與密碼]
`-h`	顯示用法說明^,
`-H`	顯示詳細的用法說明，包括屬性清單與範例^,