fte: ping Ant 作業

此 IBM® MQ Managed File Transfer Ant 作業會對代理程式進行連線測試以產生回應，因此會判定代理程式是否能夠處理傳送。

屬性

代理程式 (agent)

必要項目。指定代理程式，以接受提交的 fte:ping 要求。該值的格式為：agentname@qmgrname，其中 agentname 是代理程式的名稱，qmgrname 是此代理程式直接連接的佇列管理程式的名稱。

cmdqm

選用項目。要向其提交要求的指令佇列管理程式。請使用下列格式指定此資訊：qmgrname@host@port@channel，其中：

qmgrname 為佇列管理程式的名稱
host 為執行佇列管理程式的系統的選用主機名稱
port 為佇列管理程式接聽的選用埠號
channel 為要使用的選用 SVRCONN 通道

如果省略指令佇列管理程式的 host、port 或 channel 資訊，則會使用 command.properties 檔案中所指定的連線資訊。如需相關資訊，請參閱 MFT command.properties 檔案。

您可以使用 com.ibm.wmqfte.propertySet 內容，指定所要使用的 command.properties 檔案。如需相關資訊，請參閱 com.ibm.wmqfte.propertySet。

如果您不使用 cmdqm 屬性，此作業會預設為使用 com.ibm.wmqfte.ant.commandQueueManager 內容（如果已設定此內容）。如果未設定 com.ibm.wmqfte.ant.commandQueueManager 內容，將會嘗試連線到 command.properties 檔案中所定義的預設佇列管理程式。 com.ibm.wmqfte.ant.commandQueueManager 內容的格式與 cmdqm 屬性相同，即 qmgrname@host@port@channel。

rcproperty

必要項目。指定內容，以儲存 ping 作業的回覆碼。

逾時

選用項目。作業等待代理程式回應的最長時間量（以秒為單位）。最短逾時是零秒，不過，也可指定 -1 逾時，讓指令永久等待代理程式回應。如果未指定 timeout 的值，預設等待代理程式回應的最長時間為 5 秒。

範例

此範例將 fte:ping 要求傳送至 qm1 所管理的 agent1。此 fte:ping 要求等待代理程式回應的時間為 15 秒。 fte:ping 要求的結果儲存在稱為 ping.rc 的內容中。


<fte:ping agent="agent1@qm1" rcproperty="ping.rc" timeout="15"/>

回覆碼

0: 指令已順利完成。
2: 指令逾時。