fteStart代理程式 (啟動 MFT 代理程式)

fteStartAgent 指令會從指令行啟動 Managed File Transfer 代理程式。

用途

使用 fteStartAgent 指令來啟動 Managed File Transfer 代理程式。必須先啟動代理程式，才能將它用來執行檔案傳送。 fteStartAgent 指令會在您發出指令的系統上啟動代理程式：您無法在遠端系統上啟動代理程式。

若為 IBM® WebSphere® MQ 7.5 或更新版本，代理程式處理程序控制器會管理啟動代理程式。不過，代理程式程序控制器可能會等待一段時間（例如，代理程式的失敗率很高時），再嘗試重新啟動代理程式。作為 IBM MQ 管理者，您可以使用 fteStartAgent 指令來置換此等待，並起始啟動代理程式。如果代理程式程序控制器在等待佇列管理程式變成可用，這個指令也會起始代理程式程序控制器以嘗試重新連接佇列管理程式。

[Windows] 如果您已使用 fteCreate代理程式或 fteModify代理程式指令，將代理程式配置成以 Windows 服務方式執行，則執行 fteStartAgent 指令會啟動 Windows 服務。

如果代理程式未動或已啟動，此指令會傳回錯誤。代理程式會根據 agent.properties 檔案中定義的值，與其佇列管理程式進行通訊。

請僅在要使用一組不同於您的預設集的配置選項時，才為此指令指定選用的 -p 參數。如需相關資訊，請參閱 MFT agent.properties 檔案。

Syntax

fteStartAgent

參數

-F: 選用項目。此參數以前景程序方式來執行代理程式常駐程式。依預設是在背景中執行代理程式常駐程式。
如果您是在 Windows上執行，且已使用 fteCreateAgent 或 fteModifyAgent 指令將代理程式配置成以 Windows 服務方式執行，則 -F 參數會置換此配置。
-p configuration_options: 選用項目。此參數決定一組用來發出要求以啟動代理程式的配置選項。請使用非預設協調佇列管理程式的名稱作為此參數的輸入。然後，指令即會使用與此非預設協調佇列管理程式相關聯的一組內容檔。
如果未指定此參數，則會使用一組以預設協調佇列管理程式為基礎的配置選項。
agent_name: 必要項目。您要啟動的 Managed File Transfer 代理程式名稱。
-? 或 -h: 選用項目。顯示指令語法。

範例

在此範例中，AGENT2 在前景中啟動及執行。


fteStartAgent -F AGENT2

在下列範例中 (若為 AIX® and Linux® 系統) ，會使用非預設協調佇列管理程式 QM_SATURN 來啟動 AGENT2 :


./fteStartAgent -p QM_SATURN AGENT2

您也可以如下所示指定 fteStartAgent 的路徑來執行此指令：


path/fteStartAgent agentname

回覆碼

0 (RC_SUCCESS): 指令已順利完成。
1 (RC_FAILURE): 指令未順利結束。
78 (RC_CONFIG): 發現配置錯誤。
79 (RC_API_ERROR): 發生 MFT 異常狀況。
80 (RC_IO_ERROR): 發生 Java IOException。
81 (RC_IPC_ERROR): 發生 MFT 交互程序通訊錯誤。

回應

在某些情況下，您在執行 fteStartAgent 指令之後可能會看見錯誤訊息：

如果您執行 fteStartAgent 指令並看到下列錯誤訊息，則您的環境可能具有與 Managed File Transfer衝突的其他程式庫路徑:
```
BFGCL0001E: An internal error has occurred. 異常狀況為：'CC=2;RC=2495;AMQ8568:
 找不到原生 JNI 程式庫 'mqjbnd'。[3=mqjbnd]
```
當代理程式是以 Java 32 位元版本執行時（目前大部分平台都是如此），如果 LD_LIBRARY_PATH 或 LIBPATH 環境變數設為在 32 位元版本之前先參照 64 位元版本程式庫，則會發生此錯誤。
若要解決此問題，請設定 Managed File Transfer 代理程式內容 javaLibrary路徑，以參照程式庫的正確位置。例如，若為 AIX 上的 mqjbnd，請設為：/usr/mqm/java/lib。若為 Linux 上的 mqjbnd，請設為: /opt/mqm/java/lib