|
| |
| Sun Java System Message Queue 3 2005Q1 管理指南 | |
第 13 章
指令參照本章有一節描述一般指令行語法，並提供每個 Message Queue 指令的參照資訊。本章包含以下各節：
指令行語法Message Queue 指令行公用程式是 Shell 指令。公用程式名稱是一個指令，其子指令或選項是傳給指令的引數。因此，沒有指令可啟動或退出公用程式，而且就公用程式本身而言也無需此類指令。
所有指令行公用程式共用以下指令語法：
Utility_Name [subcommand] [argument] [[-option_name [-option_argument]]…]
Utility_Name 指定 Message Queue 公用程式的名稱，例如，imqcmd、imqobjmgr 和 imqusermgr 等。
指令的輸入規則
輸入指令時，有幾個一般規則：
指令行範例
以下為沒有子指令子句的指令行範例。此指令啟動預設代理程式。
imqbrokerd
下列指令更複雜。這個指令銷毀名稱為 myQueue 的 queue 類型目標。根據使用者 admin 執行認證；指令會提示您輸入使用者的密碼。-f 選項指定無確認，-s 選項指定以無訊息模式執行指令。
imqcmd destroy dst -t q -n myQueue -u admin -f -s
共用的指令選項
表 13-1 描述了所有 Message Queue 管理公用程式共用的選項。在指令行上指定這些選項時，必須放在子指令的後面。選項的輸入順序不拘。
imqbrokerdimqbrokerd 指令可以啟動代理程式。指令行選項可覆寫代理程式配置檔案中的值，但僅用於目前的代理程式階段作業。
語法
指令選項
表 13-2 描述了 imqbrokerd 指令的選項，還描述了每個選項影響的配置特性 (如果有)。
表 13-2 imqbrokerd 選項
選項
影響的特性
說明
-backup fileName
無影響的特性。
僅套用於代理程式叢集。將主代理程式的配置變更記錄備份至指定檔案。請參閱管理配置變更記錄。
-cluster"[broker1]
[[,broker2]…]”
其中 broker 為以下之一將 imq.cluster.brokerlist 覆寫成與其連線的代理程式清單。
僅套用於代理程式叢集。連線至指定主機和連接埠上的所有代理程式。此清單已與 imq.cluster.brokerlist 特性中的清單合併。如果您沒有為主機指定值，則使用 localhost。如果您沒有為 port 指定值，則使用值 7676。請參閱使用代理程式叢集，以獲得有關如何使用此選項連線多重代理程式的更多資訊。
-dbpassword password
將 imq.persist.jdbc.
password 覆寫成指定的密碼為外掛 JDBC 相容資料儲存指定密碼。這個選項已經被停用，將從未來的版本中移除。請使用下列其中一種替代方案：
-dbuser userName
將 imq.persist.jdbc.user
覆寫成指定的使用者名稱為外掛 JDBC 相容資料庫指定使用者名稱。請參閱設定永久性儲存。
-Dproperty=value
設定系統特性。覆寫實例配置檔案中的相應特性值。
將指定的特性設定為指定的值。請參閱第 14 章「代理程式特性參照」，以獲得代理程式配置特性的相關資訊。
警告：請仔細檢查使用 -D 選項設定的特性的拼寫與格式。如果您傳送了錯誤的值，系統將不警告您，並且 Message Queue 亦無法設定這些值。
-force
無影響的特性。
未經使用者確認即執行動作。此選項僅套用通常要求確認的
-remove instance 和 -upgrade-store-nobackup 選項。-h|-help
無影響的特性。
顯示說明。不執行指令行上的其他任何指令。
-javahome path
無影響的特性。
指定替代 Java 2 相容 JDK 的路徑。預設為使用隨附的執行階段。
-ldappassword
password將 imq.user_repository.
ldap.password 覆寫成指定的密碼為存取 LDAP 使用者儲存庫指定密碼。這個選項已經被停用，將從未來的版本中移除。請使用下列其中一種替代方案：
-license [licenseName]
無影響的特性。
如果要載入的授權與 Message Queue 產品版本預設的授權不同，則指定要載入的授權。如果您尚未指定授權名稱，則此項會列出系統上安裝的所有授權。根據已安裝的 Message Queue 版本，licenseName 值為 pe (Platform Edition - 基本特性)、try (Platform Edition - 90 天試用企業特性) 和 unl (Enterprise Edition)。
-loglevel level
將 imq.broker.log.level 覆寫成指定的級別。
將記錄級別指定為以下之一：NONE、ERROR、WARNING 或 INFO。預設值為 INFO。
-metrics interval
將 imq.metrics.interval 覆寫成指定的秒數。
指定按指定間隔時間 (以秒為單位) 將代理程式度量寫入記錄程式中。
-name instanceName
將 imq.instancename 設定為指定的名稱。
指定此代理程式的實例名稱，並使用相應的實例配置檔案。如果您沒有指定代理程式名稱，則將實例名稱設定為 imqbroker。
備註：如果您在同一主機上執行代理程式的多個實例，則每個實例必須具有唯一的名稱。-passfile fileName
覆寫 imq.passfile.enabled，並且設定為 true。將 imq.passfile.dirpath 覆寫成檔案路徑。將 imq.passfile.name 覆寫成檔案名稱。
指定檔案的名稱，您可從此檔案讀取 imqcmd 指令公用程式、SSL 密鑰儲存、LDAP 使用者儲存庫、JDBC 相容資料庫或上述任何組合的密碼。如需更多資訊，請參閱使用密碼檔案。
-password keypassword
將 imq.keystore.password 覆寫成指定的密碼。
指定 SSL 憑證密鑰儲存的密碼。這個選項已經被停用，將從未來的版本中移除。請使用下列其中一種替代方案：
-port number
將 imq.portmapper.port 覆寫成指定的號碼。
指定代理程式的連接埠對映器連接埠號。依預設，此項設定為 7676。若要在同一伺服器上執行代理程式的兩個實例，則每個代理程式的連接埠對映器必須有不同的連接埠號。Message Queue 用戶端會使用此連接埠號連線至代理程式實例。
-remove instance
無影響的特性。
導致移除代理程式實例：刪除此實例配置檔案、記錄檔、永久性儲存以及與此實例相關聯的其他檔案和目錄。要求使用者確認，除非也指定了 -force 選項。
-reset store| messages|
durables|
props無影響的特性。
依據給定的引數，重設資料儲存 (或資料儲存的子集) 或代理程式實例的配置特性。
重設資料儲存，清除所有永久性資料，包括永久性訊息、長期訂閱和作業事件資訊。此項可讓您啟動沒有記錄的代理程式實例。您還可以僅清除所有永久性訊息或僅清除所有長期訂閱。(如果您不想在後續的重新啟動中重設永久性儲存，請重新啟動未使用 -reset 選項的代理程式實例。)
重設代理程式的特性，用空白檔案取代現有實例配置檔案 (config.properties)：所有特性均假設為預設值。
-restore fileName
無影響的特性。
僅套用於代理程式叢集。用指定的備份檔案取代主代理程式的配置變更記錄。此檔案必須已使用 -backup 選項事先建立。請參閱管理配置變更記錄。
-shared
覆寫 imq.jms.
threadpool_model，並且設定為 shared。指定要使用共用執行緒池模型實作的 jms 連線服務，在此模型中，執行緒在各連線之間共用以增加代理程式實例支援的連線數目。
-silent|-s
覆寫 imq.log.console.
output，並且設定為 NONE。關閉對主控台的記錄。
-tty
覆寫 imq.log.console.
output，並且設定為 ALL指定所有訊息均在主控台顯示。依預設，僅顯示 WARNING 和 ERROR 級別的訊息。
-upgrade-store-
nobackup無影響的特性
指定從不相容的版本升級到 Message Queue 3.5 或 Message Queue 3.5 SPx 時會自動移除舊的資料儲存。如需其他詳細資訊，請參閱 Message Queue Installation Guide。
-version
無影響的特性。
顯示安裝產品的版本編號。
-vmargs arg1 [[arg2]…]
無影響的特性
指定要傳送至 Java VM 的引數。用空格分隔各引數。如果您要傳送多個引數，或者如果引數包含空格，請使用括起的引號。例如：
imqbrokerd -tty -vmargs "-Xmx128m -Xincgc"您只能在指令行上傳送這些引數。config.props 檔案中沒有相關的配置特性。
另請參閱
如需有關使用 imqbrokerd 的詳細資訊和指令範例，請參閱以互動方式啟動代理程式。
imqcmdimqcmd 指令公用程式能讓您管理代理程式及其服務。
語法
imqcmd subcommand argument [options]
imqcmd -h|H
imqcmd -v子指令
您使用 imqcmd 時一定使用子指令，除非是顯示說明或產品版本。表 13-3 列出 imqcmd 子指令，並指出子指令參照資訊的位置。
表 13-3 imqcmd 子指令
子指令與引數
說明
參照
commit txn
確定作業事件。
destroy dur
銷毀長期訂閱。
list cxn
列出代理程式的連線。
list dur
列出主題的長期訂閱。
list svc
列出代理程式上的服務。
list txn
列出代理程式上的作業事件。
metrics bkr
顯示代理程式度量。
metrics svc
顯示服務度量。
pause bkr
暫停代理程式上的所有服務。
pause svc
暫停代理程式上的單一服務。
purge dur
清除長期訂閱上的所有訊息而不銷毀長期訂閱。
query bkr
查詢並顯示代理程式的相關資訊。
query cxn
查詢並顯示連線的相關資訊。
query svc
查詢並顯示服務的相關資訊。
query txn
查詢並顯示作業事件的相關資訊。
reload cls
重新載入代理程式叢集配置。
restart bkr
重新啟動目前執行的代理程式實例。
resume bkr
繼續代理程式上的所有服務。
resume svc
繼續服務。
rollback txn
回轉作業事件。
shutdown bkr
關閉代理程式實例。
update bkr
更新代理程式的屬性。
update svc
更新服務的屬性。
imqcmd 指令公用程式也有子指令要用於代理程式的實體目標。第 6 章「管理實體目標」中有描述目標子指令。
下面幾節依功能列出 imqcmd 的子指令。
代理程式管理子指令
表 13-4 列出用來管理代理程式的 imqcmd 子指令。如果未指定主機名稱或連接埠，則使用預設值 (localhost:7676)。
表 13-4 imqcmd 子指令用於管理代理程式
子指令語法
說明
metrics bkr [-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]顯示預設代理程式或指定主機和連接埠上的代理程式的代理程式度量。
使用 -m 選項指定要顯示的度量類型：
ttl 顯示代理程式流入和流出訊息和封包的度量。(預設度量類型)
rts 顯示代理程式 (每秒) 流入和流出訊息和封包之流量速率的度量。
cxn 顯示連線、虛擬記憶體堆疊和執行緒。
使用 -int 選項，指定顯示度量的間隔時間 (以秒為單位)。預設為 5 秒鐘。
使用 -msp 選項，指定輸出中顯示的範例數目。預設的數目為沒有限制 (無限)。
pause bkr [-b hostName:port]
暫停預設代理程式或指定主機和連接埠上的代理程式。請參閱暫停與繼續代理程式。
query bkr -b hostName:port
列出預設代理程式或指定主機和連接埠上的代理程式特性的目前設定。還顯示連線至指定代理程式的執行中的代理程式 (在多重代理程式叢集中) 之清單。
reload cls
僅套用於代理程式叢集。強制叢集中的所有代理程式重新載入 imq.cluster.brokerlist 特性並更新叢集資訊。請參閱將代理程式新增至叢集，以獲得更多資訊。
restart bkr [-b hostName:port]
使用啟動代理程式時指定的選項，關閉預設代理程式或指定主機和連接埠上的代理程式後再重新啟動。
resume bkr [-b hostName:port]
繼續預設代理程式或指定主機和連接埠上的代理程式。
shutdown bkr [-b hostName:port]
關閉預設代理程式或指定主機和連接埠上的代理程式。
update bkr [-b hostName:port]
-o attribute=value
[-o attribute=value1]…變更預設代理程式或指定主機和連接埠上的代理程式的指定屬性。
實體目標管理子指令
表 13-5 列出用來管理實體目標的 imqcmd 子指令。如果未指定主機名稱或連接埠，則使用預設值 (localhost:7676)。
表 13-5 用於管理目標的 imqcmd 子指令
子指令語法
說明
compact dst [-t destType
-n destName]壓縮用於指定類型與名稱之目標的內建且基於檔案的資料儲存。如果沒有指定目標類型與名稱，所有目標都會壓縮。必須在壓縮目標前暫停目標。
create dst -t destType
-n destName
[-o attribute=value]
[-o attribute=value1]…建立指定類型、指定名稱以及指定屬性的目標。目標名稱必須僅包含字母數字字元 (無空格)，並且以字母字元或字元「_」和「$」開頭。不能以「mq」字元字串開頭。
不能在主代理程式暫時無法使用的叢集上執行這個作業。
destroy dst -t destType
-n destName銷毀指定類型和名稱的目標。不能銷毀系統建立的目標，例如，停用的訊息佇列。
不能在主代理程式暫時無法使用的叢集上執行這個作業。
list dst [-t destType] [-tmp]
列出指定類型的所有目標，以及列出暫存目標的選項。
類型引述可以有兩個值：
destType = q (queue)
destType = t (topic)如果未指定類型，則會列出所有類型的所有目標。
metrics dst -t destType
-n destName
[-m metricType]
[-int interval]
[-msp numSamples]顯示有關指定類型和名稱之目標的度量資訊。
使用 -m 選項指定要顯示的度量類型：
ttl 顯示目標流入和流出訊息和封包以及常駐記憶體的度量。(預設度量類型)
rts 顯示目標 (每秒) 流入和流出訊息和封包之流量速率的度量，及其他速率資訊。
con 顯示用戶相關的度量。
dsk 顯示磁碟使用度量。
使用 -int 選項，指定顯示度量的間隔時間 (以秒為單位)。預設為 5 秒鐘。
使用 -msp 選項，指定輸出中顯示的範例數目。預設的數目為沒有限制 (無限)。
pause dst [-t destType
-n destName]
[-pst pauseType]針對指定類型和名稱的目標，暫停至用戶的訊息傳送 (-pst CONSUMERS)，或暫停來自產生者的訊息傳送 (-pst PRODUCERS)，或者兩者皆暫停 (-pst ALL)。如果沒有指定目標類型與名稱，則會暫停所有目標。預設為 ALL。
purge dst -t destType
-n destName清除在指定類型與名稱的目標的訊息。
query dst -t destType
-n destName列出指定類型和名稱之目標的相關資訊。
resume dst [-t destType
-n destName]繼續用於指定類型和名稱之暫停目標的訊息傳送。如果沒有指定目標類型與名稱，則會繼續所有目標。
update dst -t destType
-n destName
-o attribute=value
[-o attribute=value1]…更新指定目標上的指定屬性的值。
屬性名稱可能是表 15-1 中描述的任何屬性，除非目標是停用的訊息佇列 mq.sys.dmq。
連線服務管理子指令
表 13-6 列出用來管理連線服務的 imqcmd 子指令。如果未指定主機名稱或連接埠，則使用預設值 (localhost:7676)。
表 13-6 用於管理連線服務的 imqcmd 子指令
子指令語法
說明
list svc [-b hostName:port]
列出預設代理程式或指定主機和連接埠上的代理程式上的所有連線服務。
metrics svc -n serviceName
[-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]顯示預設代理程式或指定主機和連接埠上的代理程式上的指定服務之標準資訊。
使用 -m 選項指定要顯示的度量類型：
ttl 顯示代理程式經由指定服務，流入和流出訊息和封包的度量。(預設度量類型)
rts 顯示代理程式經由指定連線服務，(每秒) 流入和流出訊息和封包之流量速率的度量。
cxn 顯示連線、虛擬記憶體堆疊和執行緒。
使用 -int 選項，指定顯示度量的間隔時間 (以秒為單位)。預設為 5 秒鐘。
使用 -msp 選項，指定輸出中顯示的範例數目。預設的數目為沒有限制 (無限)。
pause svc -n serviceName
[-b hostName:port]暫停在預設代理程式或指定主機和連接埠上的代理程式上執行的指定服務。您無法暫停管理服務。
query svc -n serviceName
[-b hostName:port]顯示在預設代理程式或指定主機和連接埠上的代理程式上執行的指定服務的相關資訊。
resume svc -n serviceName
[-b hostName:port]繼續在預設代理程式或指定主機和連接埠上的代理程式上執行的指定服務。
update svc -n serviceName
[-b hostName:port]
-o attribute=value
[-o attribute=value1]…更新在預設代理程式或指定主機和連接埠上的代理程式上執行的指定服務的指定屬性。如需服務屬性的說明，請參閱連線服務特性。
連線子指令
表 13-7 列出套用於連線的 imqcmd 子指令。如果未指定主機名稱或連接埠，則假設它們為 localhost 和 7676。
表 13-7 用於管理連線服務的 imqcmd 子指令
子指令語法
說明
list cxn [-svn serviceName]
[-b hostName:port]列出預設代理程式上指定服務名稱的所有連線，或指定主機和連接埠上代理程式上的所有連線。如果未指定服務名稱，則會列出所有服務。
query cxn -n connectionID
[-b hostName:port]顯示在預設代理程式或指定主機和連接埠上的代理程式上，指定服務的相關資訊。
長期訂閱子指令
表 13-8 提供了 imqcmd 長期訂閱子指令的摘要。如果未指定主機名稱或連接埠，則使用預設值 (localhost 和 7676)。
表 13-8 用於管理長期訂閱的 imqcmd 子指令
子指令
說明
list dur -d destName
列出指定目標的所有長期訂閱。
destroy dur -n subscrName
-c client_id使用指定的用戶端識別碼銷毀指定的長期訂閱。
不能在主代理程式暫時無法使用的叢集上執行這個作業。
purge dur -n subscrName
-c client_id使用指定的用戶端識別碼清除指定之長期訂閱的所有訊息。
作業事件管理子指令
表 13-9 提供了 imqcmd 作業事件子指令的摘要。如果未指定主機名稱或連接埠，則使用預設值 (localhost 和 7676)。
表 13-9 用於管理作業事件的 imqcmd 子指令
子指令
說明
list txn
列出要由代理程式追蹤的所有作業事件。
query txn -n transaction_id
列出指定作業事件的相關資訊。
commit txn -n transaction_id
確定指定的作業事件。
rollback txn -n transaction_id
回轉指定的作業事件。
指令選項
表 13-10 列出 imqcmd 指令的選項。
表 13-10 imqcmd 選項
選項
說明
-b hostName:port
指定代理程式主機名稱及其連接埠號。預設值為 localhost:7676。
僅指定連接埠：-b :7878
僅指定名稱： -b somehost-c clientID
將長期用戶的 ID 指定至主題。請參閱管理長期訂閱。
-d destinationName
指定主題名稱。與 list dur 和 destroy dur 子指令配合使用。請參閱管理長期訂閱。
-f
未經使用者確認即執行動作。
-h
顯示用法說明。不執行指令行上的其他任何指令。
這個選項不需要使用者名稱和密碼。
-H
顯示用法說明、屬性清單和範例。不執行指令行上的其他任何指令。
這個選項不需要使用者名稱和密碼。
-int interval
指定 metrics bkr、metrics dst 與 metrics svc 子指令顯示度量輸出的時間間隔 (以秒為單位)。
-javahome path
指定要使用的替代 Java 2 相容執行階段 (預設為使用系統上的執行階段，或 Message Queue 隨附的執行階段)。
-m metricType
指定要顯示的度量資訊類型。將此選項與 metrics dst、metrics svc 或 metrics bkr 子指令配合使用。metricType 的值會根據是否產生用於目標、服務或代理程式的度量而變化。
-msp numSamples
指定度量輸出中，顯示作為metrics bkr、metrics dst 與 metrics svc 子指令範例的度量數目。
-n argumentName
指定子指令引數的名稱。此選項可能為服務名稱、實體目標名稱、長期訂閱名稱、連線 ID 或作業事件 ID，這取決於子指令。
-o attribute=value
指定屬性的值。此選項可以為代理程式 (請參閱使用 imqcmd 指令公用程式) 的屬性、服務 (請參閱管理連線服務) 的屬性或目標 (請參閱管理長期訂閱) 的屬性，這取決於子指令引數。
-p password
指定您的 (管理員的) 密碼。這個選項已經被停用，未來的版本不支援。請使用下列其中一種替代方案：
-passfile path
指定包含使用者下達指令時所需密碼的檔案路徑。如需更多資訊，請參閱使用密碼檔案。
-pst pauseType
暫停目標時，指定是否要暫停產生者、用戶或兩者皆暫停。請參閱管理長期訂閱。
-rtm timeout
指定 imqcmd 子指令的初始 (重試) 逾時期間 (以秒為單位)。送出請求到代理程式後，imqcmd 子指令將等待的逾時時間長度。每個子指令的後續重試會使用一個逾時值，該逾時值為初始逾時期間的倍數。預設值： 10
-rtr numRetries
指定 imqcmd 子指令第一次逾時後，嘗試重試的次數。預設值： 5
-s
無訊息模式。不顯示輸出。
-secure
使用 ssladmin 連線服務指定與代理程式的安全管理連線 (請參閱步驟 4. 配置並執行基於 SSL 的用戶端)。如果省略這個選項，連線可能會不安全。
-svn serviceName
指定所列出連線的服務。請參閱取得有關連線的資訊。
-t destType
指定目標的類型：t (主題) 或 q (佇列)。請參閱管理長期訂閱。
-tmp
顯示暫存目標。請參閱表 13-5。
-u userName
指定您的 (管理員的) 名稱。如果您遺漏此值，系統將提示您提供此名稱。
-v
顯示版本資訊。不執行指令行上的其他任何指令。
這個選項不需要使用者名稱和密碼。
另請參閱
如需有關使用 imqcmd 的詳細資訊和指令範例，請參閱第 5 章「管理代理程式」和第 6 章「管理實體目標」。
imqobjmgr物件管理員公用程式 (imqobjmgr) 可以建立並管理 Message Queue 受管理物件。
語法
imqobjmgr subcommand [options]
imqobjmgr -h|H
imqobjmgr -v子指令
物件管理員公用程式 (imqobjmgr) 包括表 13-3 中列出的子指令：
表 13-11 imqobjmgr 子指令
子指令
說明
add
將受管理物件新增至物件儲存。
delete
從物件儲存刪除受管理物件。
list
列出物件儲存中的受管理物件。
query
顯示有關指定的受管理物件的資訊。
update
修改物件儲存中的現有受管理物件。
指令選項
表 13-12 列出 imqobjmgr 指令的選項。如需它們用法的說明，請參閱以下基於工作的各節。
表 13-12 imqobjmgr 選項
選項
說明
-f
未經使用者確認即執行動作。
-h
顯示用法說明。不執行指令行上的其他任何指令。
-H
顯示用法說明、屬性清單和範例。不執行指令行上的其他任何指令。
-i fileName
指定指令檔的名稱，此檔案包含所有或部分子指令子句，可指定物件類型、查找名稱、物件屬性、物件儲存屬性或其他選項。通常用於重複資訊，如物件儲存屬性。
-j attribute=value
指定識別和存取 JNDI 物件儲存所需的屬性。請參閱關於物件儲存。
-javahome path
指定要使用的替代 Java 2 相容執行階段 (預設為使用系統上的執行階段，或 Message Queue 隨附的執行階段)。
-l lookupName
指定受管理物件的 JNDI 查找名稱。此名稱在物件儲存的環境中必須唯一。
-o attribute=value
指定受管理物件的屬性。請參閱第 16 章「受管理物件屬性參照」。
-pre
預覽模式。表示在不執行指令的情況下將進行的動作。
-r read-only_state
指定受管理物件是否為唯讀物件。值 true 表示受管理物件為唯讀物件。用戶端無法修改唯讀受管理物件的屬性。依預設，唯讀狀態設定為 false。
-s
無訊息模式。不顯示輸出。
-t objectType
指定 Message Queue 受管理物件的類型：
q = 佇列
t = 主題
cf = 連線工廠
qf = 佇列連線工廠
tf = 主題連線工廠
xcf = XA 連線工廠 (分散式作業事件)
xqf = XA 佇列連線工廠 (分散式作業事件)
xtf = XA 主題連線工廠 (分散式作業事件)
e = SOAP 端點 (這個受管理物件類型如 Message Queue Developer’s Guide for Java Clients 中所描述，是用來支援 SOAP 訊息。)
-v
顯示版本資訊。不執行指令行上的其他任何指令。
另請參閱
如需有關 imqobjmgr 的詳細資訊和指令範例，請參閱第 8 章「管理受管理物件」
imqdbmgr資料庫管理員公用程式 (imqdbmgr) 可以設定持續性所需的模式。您也可以使用 imqdbmgr 指令來刪除毀損的 Message Queue 資料庫表格，或變更資料儲存。
語法
imqdbmgr subcommand argument [options]
imqdbmgr -h|-help
imqdbmgr -v|-version子指令
資料庫管理員公用程式 (imqdbmgr) 包括表 13-13 中列出的子指令：
表 13-13 imqdbmgr 子指令
子指令
和引數說明
create all
建立新資料庫和 Message Queue 永久性儲存模式。此指令可在內嵌式資料庫系統上使用，當使用此指令時，需要指定特性 imq.persist.jdbc.createdburl。
create tbl
在現有資料庫系統中建立 Message Queue 永久性儲存模式。此指令可在外部資料庫系統上使用。
delete tbl
在目前永久性儲存資料庫中刪除現有 Message Queue 資料庫表格。
delete oldtbl
刪除所有較早版本之永久性儲存資料庫中的 Message Queue 資料庫表格。在自動將永久性儲存轉移到 Message Queue 目前版本後使用。
recreate tbl
在目前永久性儲存資料庫中刪除現有 Message Queue 資料庫表格，然後重新建立 Message Queue 永久性儲存模式。
reset lck
重設鎖定狀態，以便其他程序可以使用永久性儲存資料庫。
指令選項
表 13-14 列出了 imqdbmgr 指令的選項。
表 13-14 imqdbmgr 選項
選項
說明
-Dproperty=value
將指定的特性設定為指定的值。
-b instanceName
指定代理程式實例名稱並使用相應的實例配置檔案。
-h
顯示用法說明。不執行指令行上的其他任何指令。
-p password
指定資料庫密碼。這個選項已經被停用，未來的版次不支援。請使用下列其中一種替代方案：
-passfile path
指定包含資料庫密碼的檔案路徑。如需更多資訊，請參閱使用密碼檔案。
-u name
指定資料庫使用者名稱。
-v
顯示版本資訊。不執行指令行上的其他任何指令。
另請參閱
如需有關設定永久性儲存的詳細資訊，請參閱設定永久性儲存。
imqusermgr使用者管理員公用程式 (imqusermgr) 可讓您編輯或寫入文字檔案使用者儲存庫。使用 imqusermgr 前，請注意以下事項：
語法
imqusermgr subcommand [options]
imqusermgr -h
imqusermgr -v子指令
表 13-15 列出本章中描述的 imqusermgr 子指令。
表 13-15 imqusermgr 子指令
子指令
說明
add [-i instanceName] -u userName -p passwd
[-g group] [-s]將使用者和相關密碼新增到指定的 (或預設的) 代理程式實例儲存庫，並選擇性地指定使用者的群組。
delete [-i instanceName] -u userName [-s] [-f]
從指定的 (或預設的) 代理程式實例儲存庫刪除指定的使用者。
list [-i instanceName] [-u userName]
顯示有關指定的 (或預設的) 代理程式實例儲存庫中，指定的使用者或所有使用者的資訊。
update [-i instanceName] -u userName -p passwd
[-a state] [-s] [-f]update [-i instanceName] -u userName -a state
[-p passwd] [-s] [-f]更新指定的 (或預設的) 代理程式實例儲存庫中，指定之使用者的密碼和/或狀態。
指令選項
表 13-16 列出了 imqusermgr 指令的選項。
表 13-16 imqusermgr 選項
選項
說明
-a active_state
指定使用者的狀態是否應為使用中 (true/false)。值 true 表示狀態為使用中。這是預設值。
-f
執行動作而無需使用者確認
-h
顯示用法說明。不執行指令行上的其他任何指令。
-i instanceName
指定代理程式實例使用者儲存庫套用的指令。如果未指定，則假設為預設實例名稱值 imqbroker。
-p passwd
指定使用者密碼。
-g group
指定使用者群組。有效值為 admin、user 和 anonymous。
-s
設定無訊息模式。
-u userName
指定使用者名稱。
-v
顯示版本資訊。不執行指令行上的其他任何指令。
另請參閱
如需有關設定及管理使用文字檔案使用者儲存庫的詳細資訊和 imqusermgr 指令範例，請參閱使用文字檔案使用者儲存庫。
imqsvcadmin服務管理 (imqsvcadmin) 公用程式可以將代理程式安裝為 Windows 服務。
語法
imqsvcadmin subcommand [options]
imqsvcadmin -h
子指令
Message Queue 服務管理員公用程式 (imqsvcadmin) 包括表 13-17 中列出的子指令：
表 13-17 imqsvcadmin 子指令
子指令
說明
install
安裝服務並指定啟動選項。
query
顯示 imqsvcadmin 指令的啟動選項。這包括服務是手動啟動還是自動啟動、服務的位置、Java 執行階段的位置以及啟動時傳送至代理程式的引數的值。
remove
移除服務。
指令選項
表 13-18 列出 imqsvcadmin 指令的選項。
表 13-18
imqsvcadmin 選項選項
說明
-h
顯示用法說明。不執行指令行上的其他任何指令。
-javahome path
指定要使用的替代 Java 2 相容執行階段的路徑 (預設為使用系統上的執行階段，或 Message Queue 隨附的執行階段)。
範例︰imqsvcadmin -install -javahome d:\jdk1.4
-jrehome path
指定 Java 2 相容的 JRE 的路徑。
範例︰imqsvcadmin -install -jrehome d:\jre\1.4
-vmargs arg [[arg]…]
指定要傳送至正在執行代理程式服務的 Java VM 的其他引數。(您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些引數。)
範例︰-vmargs "-Xms16m -Xmx128m"
-args arg [[arg]…]
指定要傳送至代理程式服務的其他指令行引數。如需 imqbrokerd 選項的說明，請參閱 imqbrokerd。
(您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些引數。)例如，
imqsvcadmin -install
-args "-passfile d:\imqpassfile"
您使用 -javahome、-vmargs 和 -args 選項時指定的資訊，儲存在 Window 登入檔中的鍵值 JREHome、JVMArgs 和 ServiceArgs 下，路徑為：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
\Services\iMQ_Broker\Parameters另請參閱
如需有關將 Message Queue 當做 Windows 服務來執行的詳細資訊，請參閱在 Windows 自動啟動。
imqkeytoolimqusermgr 指令可以為代理程式產生自身簽名的憑證。同樣的憑證可以用於 ssljms、ssladmin 或 cluster連線服務。若是 UNIX 系統，您可能需要從 superuser (超級使用者) 帳號，執行 imqkeytool。
語法
imqkeytool -broker
另請參閱
如需有關設定安全連線的詳細資訊，請參閱使用基於 SSL 的服務。