fte: 取消 Ant 任务

取消 Managed File Transfer 受管传输或受管调用。受管传输可能是使用 fte:filecopy 或 fte:filemove 任务创建的。受管调用可能是使用 fte:call 任务创建的。

属性

客服

必需。指定要将 fte:cancel 请求提交给的代理。值的格式如下：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。

id

必需。指定要取消的传输的传输标识。传输标识是在 fte: filecopy 和 fte: filemove 任务提交传输请求时生成的。

origuser

可选。指定要与 cancel 请求相关联的始发用户标识。如果未使用 origuser 属性，那么该任务将缺省使用用于运行 Ant 脚本的用户标识。

示例

将 fte:cancel 请求发送给命令队列管理器 qm0 的示例。 fte:cancel 请求针对队列管理器 qm1 上的 agent1 且由 transfer.id 变量填充的传输标识。使用 bob 用户标识运行请求。

<fte:cancel cmdqm="qm0@localhost@1414@SYSTEM.DEF.SVRCONN" 
            agent="agent1@qm1"
            id="${transfer.id}"
            origuser="bob"/>