附錄 D 將代理程式用作 Windows 服務

本附錄介紹如何使用服務管理員 (imqsvcadmin) 公用程式來安裝、查詢和移除作為 Windows 服務執行的代理程式。

將代理程式作為 Windows 服務執行

安裝 Message Queue 時，您可以選擇將代理程式作為 Windows 服務安裝。您也可以在安裝 Message Queue 後，使用 imqsvcadmin 將代理程式作為 Windows 服務安裝。

將代理程式作為 Windows 服務安裝，意味著此代理程式將在系統啟動時啟動，並在後台執行直至關機。因此，您不必使用 imqbrokerd 指令啟動代理程式，除非您要啟動其他實例。若要將所有啟動選項傳送至代理程式，您可以使用 imqsvcadmin 指令 (請參閱表 D-2) 的 -args 引數，並確切地指定您已為 imqbrokerd 指令 (請參閱「啟動代理程式」) 使用的相同選項。使用 imqcmd 指令以控制代理程式照常作業。

當代理程式作為 Windows 服務執行時，[工作管理員] 會將代理程式作為兩個可執行程序列出。第一個程序是 imqbrokersvc.exe，這是原生 Windows 服務包裝。第二個程序是實際執行代理程式的 Java 運行時間。

服務管理員公用程式 (imqsvcadmin)

服務管理員公用程式 (imqsvcadmin) 可讓您安裝、查詢和移除代理程式 (作為 Windows 服務執行)。本節描述 imqsvcadmin 指令的基本語法、提供子指令的清單、總結 imqsvcadmin 指令選項，並介紹如何使用這些指令來完成特定的工作。

imqsvcadmin 指令的語法

請注意，如果您指定 -v、-h、或 -H 選項，則系統不會執行指令行上指定的其他子指令。例如，如果您輸入以下指令，則系統會顯示說明資訊但不會執行 query 子指令。

imqsvcadmin 子指令

Message Queue 服務管理員公用程式 (imqsvcadmin) 包括表 D-1 中列出的子指令：

表 D-1 imqsvcadmin 子指令
子指令	說明
install	安裝服務並指定啟動選項。
query	顯示 imqsvcadmin 指令的啟動選項。這包括服務是手動啟動還是自動啟動、服務的位置、Java 運行時間的位置以及啟動時傳送至代理程式的引數的值。
remove	移除服務。

imqsvcadmin 選項摘要

表 D-2 列出imqsvcadmin 指令的選項。如需它們用法的說明，請參閱以下基於工作的各節。

表 D-2 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 選項的說明，請參閱「啟動代理程式」。 (您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些引數。)例如， imqsvcadmin -install -args "-passfile d:\imqpassfile"

您使用 -javahome、-vmargs 和 -args 選項指定的資訊，儲存在 Window 登入檔中的鍵值 JavaHome、JVMArgs 和 ServiceArgs 下，路徑為

移除代理程式服務

在移除代理程式服務之前，您應使用 imqcmd shutdown bkr 指令關閉代理程式。然後使用 imqsvcadmin remove 指令移除服務，並重新啟動電腦。

重新配置代理程式服務

若要重新配置服務，請先移除此服務，然後將其重新安裝，並指定帶有 -args 引數的不同啟動選項。

使用替代 Java 運行時間

您可以使用 -javahome 或 -jrehome 選項來指定替代 Java 運行時間的位置。您還可以在 [Windows 服務控制台] 的 [啟動參數] 欄位中指定這些選項。請注意，[啟動參數] 欄位將反斜線 (\) 看作一個退出字元，因此當將反斜線用作路徑分割元時，您必須將其鍵入兩次；例如，-javahome d:\\jdk1.3。

查詢代理程式服務

若要確定代理程式服務的啟動選項，請使用 imqsvcadmin 指令的 -q 選項。


imqsvcadmin -query

Service iMQ_Broker is installed.
Display Name: iMQ_Broker
Start Type: Manual
Binary location: c:\Program Files\Sun Microsystems\ Message Queue 3.5\bin\imqbrokersvc
JavaHome: c:\j2sdk1.4.0
Broker Args: -passfile d:\imqpassfile

疑難排解

如果嘗試啟動服務時出現錯誤，您可以查閱透過執行以下作業記錄的錯誤事件。