使用 imqcmd 公用程式

imqcmd 公用程式能讓您管理代理程式及其服務。

如需 imqcmd 指令的語法、子指令和選項等參考資訊，請參閱第 13 章, 指令行參照。管理實體目標的參考資訊另外位於第 15 章, 實體目標特性參照中。

顯示說明

若要顯示 imqcmd 公用程式的說明，請使用 -h 或 -H 選項，且不可使用子指令。您無法取得特定子指令的說明。

例如，下列指令顯示 imqcmd 的說明：

imqcmd -H

如果您輸入的指令行除了子指令或其他選項之外，另包含 -h 或 -H 選項，則 imqcmd 公用程式只會處理 -h 或 -H 選項。忽略指令行的所有其他項目。

顯示產品版本

若要顯示 Message Queue 產品版本，可以使用 -v 選項。例如：

imqcmd -v

如果您輸入的指令行除了子指令或其他選項之外，另包含 -v 選項，則 imqcmd 公用程式只會處理 -v 選項。忽略指令行的所有其他項目。

指定使用者名稱和密碼

每個 imqcmd 子指令都要經由使用者儲存庫進行認證，因此需要使用者名稱和密碼。只有使用 -h 或 -H 選項來顯示說明的指令以及使用 -v 選項來顯示產品版本的指令除外。

指定使用者名稱

使用 -u 選項指定管理使用者名稱。如果省略使用者名稱，指令會提示您輸入。例如，下列指令會顯示預設代理程式的相關資訊：

imqcmd query bkr -u admin

為了方便您閱讀，本章範例中 -u 選項的引數都顯示預設使用者名稱 admin。在生產環境中應該使用自訂使用者名稱。

指定密碼

您可以使用下列任一方法指定密碼：

• 建立密碼檔案 (passfile)，將密碼輸入該檔案中。在指令行中使用 -passfile 選項，提供密碼檔案名稱。

• 讓指令提示您輸入密碼。

舊版 Message Queue 可讓您在 imqcmd 指令行上使用 -p 選項來指定密碼。此選項已經停用，將從未來的版本中移除。

指定代理程式名稱和連接埠

imqcmd 的預設代理程式是本地主機上執行的代理程式，預設連接埠是 7676。

對遠端主機上執行的代理程式或非預設連接埠上偵聽的代理程式下達指令時，必須使用 -b 選項來指定代理程式的主機和連接埠。

範例

本小節中的範例說明如何使用 imqcmd。

第一個範例列出在使用連接埠 7676 的 localhost 上執行的代理程式特性，因此不需要 -b 選項。指令使用預設管理使用者名稱 (admin ) 並且省略密碼，因此指令會提示您輸入密碼。

imqcmd query bkr -u admin

下列範例會列出在使用連接埠 1564 的主機 myserver 上執行的代理程式特性。使用者名稱是 aladdin。(若要讓此指令可以運作，需要更新使用者儲存庫，並將使用者名稱 aladdin 增加至 admin 群組中。)

imqcmd query bkr -b myserver:1564 -u aladdin

下列範例列出在使用連接埠 7676 的 localhost 上執行的代理程式特性。該指令的初始逾時設定為 20 秒，重試 (逾時後) 次數設定為 7。使用者密碼位於 myPassfile 密碼檔案中，該檔案位於呼叫指令時所在的目前目錄中。

imqcmd query bkr -u admin -passfile myPassfile -rtm 20 -rtr 7

如果您要與代理程式使用安全連線，可以在範例中使用 -secure 選項。-secure 選項會讓 imqcmd 使用已經配置並啟動的 ssladmin 服務。