fteModify代理程式 (以 Windows 服務方式執行 MFT 代理程式)

fteModifyAgent 指令可修改現有的代理程式，讓它能夠以 Windows 服務方式執行。此指令只能在 Windows上使用，且必須由 IBM® MQ 管理者及 mqm 群組成員的使用者執行。

Syntax

fteModifyAgent

Windows system options

參數

-agentName 代理程式名稱: 必要項目。您想要修改的代理程式名稱。
-p configuration_options: 選用項目。此參數決定一組用來修改代理程式的配置選項。依照慣例，會使用非預設協調佇列管理程式的名稱作為此參數的輸入。然後，fteModifyAgent 指令即會使用與此非預設協調佇列管理程式相關聯的一組內容檔。; 只有在您想要使用不同於預設值的配置選項時，才需指定選用的 -p 參數。如果未指定此參數，則會使用一組以預設協調佇列管理程式為基礎的配置選項。
-s service_name: 選用項目。指出代理程式以 Windows 服務方式執行。如果未指定 service_name，則此服務會命名為 mqmftAgentAGENTQMGR，其中 AGENT 是代理程式名稱，而 QMGR 是代理程式佇列管理程式名稱。; 服務的顯示名稱 (顯示在「 Windows 服務」視窗的名稱直欄中) 一律為 Managed File Transfer Agent AGENT@QMGR。
附註: 如果可重新配送的代理程式將以 Windows 服務方式執行，則需要在系統環境中設定 BFG_DATA 環境變數，服務才能運作。
-su user_name: 選用項目。代理程式要以 Windows 服務方式執行時，此參數會指定執行此服務應使用的帳戶名稱。若要使用 Windows 網域使用者帳戶來執行代理程式，請以 DomainName\UserName格式指定值。若要使用本端內建網域中的帳戶執行服務，請以 UserName 格式指定值。; 您使用 -su 參數指定的 Windows 使用者帳戶必須具有 Log on as a service 權限。如需如何授與此權限的相關資訊，請參閱以 Windows 服務方式執行 MFT 代理程式或日誌程式的指引。; 指定 -s 時需要使用此參數。
-sp password: 選用項目。此參數僅在指定 -s 時有效。
-sj options: 選用項目。當代理程式以 Windows 服務方式啟動時，此參數會以 -D 或 -X 形式定義將傳遞至 Java 虛擬機器 (JVM) 的選項清單。這些選項會使用 # 記號或分號 (;) 字元來區隔。如果必須內含任何 # 或 ; 字元，請以單引號括住這些字元。; 此參數僅在指定 -s 時有效。; 如需 fteModifyAgent 指令處理 JVM 選項更新驗證的方式的相關資訊，請參閱更新代理程式或日誌程式 JVM 選項的指引。
-sl options: 選用項目。設定 Windows 服務日誌層次。有效的選項是：error、info、warn、debug。預設值是 info。此選項在您發生 Windows 服務問題時會很有幫助。將它設為 debug，可以在服務日誌檔中提供更詳細資訊。; 此參數僅在指定 -s 時有效。
-n: 選用項目。指示代理程式以正常程序執行。此參數與 -s 選項互斥。如果既沒有指定 -s 也沒有指定 -n 選項，則代理程式會配置為一般 Windows 程序。
-? 或 -h: 選用項目。顯示指令語法。

範例

在此範例中，會修改 AGENT1，讓它以 Windows 服務方式執行：


fteModifyAgent -agentName AGENT1 -s -su fteuser -sp ftepassword

在此範例中會修改 AGENT1，以移除 Windows 服務：


fteModifyAgent -agentName AGENT1

您必須先使用 fteStopAgent 指令停止您要修改的代理程式，然後才能執行 fteModifyAgent 指令。

回覆碼

0: 指令已順利完成。
1: 指令未順利結束。