fte: ping Ant 任务

此 IBM® MQ Managed File Transfer Ant 任务对代理执行 ping 操作以获取响应，因此确定代理是否能够处理传输。

请注意： IBM'WebSphere® MQ File Transfer Edition(FTE) 不再是受支持的产品。 要从 FTE 迁移到 IBM MQ中的 Managed File Transfer 组件，请参阅 迁移 Managed File Transfer。

属性

客服
必需。 指定将 fte:ping 请求提交到的代理。 值的格式如下：agentname@qmgrname，其中 agentname 是代理的名称，qmgrname 是该代理直接连接到的队列管理器的名称。
cmdqm
可选。 请求提交到的命令队列管理器。 按以下格式指定此信息：qmgrname@host@port@channel，其中：
  • qmgrname 是队列管理器的名称
  • host 是正在运行队列管理器的系统的可选主机名
  • port 是队列管理器正在侦听的可选端口号
  • channel 是要使用的可选 SVRCONN 通道
如果省略命令队列管理器的 host、port 或 channel 信息，那么会使用 command.properties 文件中指定的连接信息。
注意: 如果没有为以下对象指定值:
  • host 变量，使用绑定方式
  • port 变量，使用值 1414
  • channel 变量， SYSTEM.DEF.SVRCONN 。
请参阅 MFT command.properties 文件 以获取更多信息。

但是，不能跳过中间的属性，例如 qmgrname@host@@channel。 例如，您可以具有 qmgrname@host， qmgrname@host@port或 qmgrname@hostport@@channel。

MFT 使用 @ 定界符拆分给定属性。 根据找到的令牌数，它采用第一个令牌作为 qmgrname，第二个令牌作为 host，第三个令牌作为 port ，最后采用 channel。

有关更多信息，请参阅 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 操作的返回码。
TIMEOUT
可选。 任务等待代理响应的最长时间（秒）。 最小超时为零秒，但也可以将超时指定为 -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
命令超时。