fteCancelTransfer（取消 "MFT转账）

用途

如果在传输正在进行时发出 fteCancelTransfer 命令，那么已在该传输过程中传输的任何文件都将保留在目标系统上而不会被删除。 在该传输过程中部分传输的任何文件都将从目标系统中删除。 传输为 已取消的传输日志的目标端。

如果取消到 Connect:Direct® 节点的传输，那么作为已取消传输的一部分部分传输的任何文件将保留在目标系统上，并且不会被删除。

您可以从可以连接到 IBM® MQ 网络的任何系统运行 fteCancelTransfer 命令，然后路由到代理队列管理器。 具体而言，要运行此命令，必须已在此系统上安装 Managed File Transfer ，并且必须已在此系统上配置 Managed File Transfer 以与 IBM MQ 网络进行通信。 如果无任何可用的连接详细信息，那么会改为将代理队列管理器详细信息用于连接，前提是这些详细信息可用。

仅当希望使用不同于缺省集的配置选项集时，才对该命令指定可选的 -p 参数。 请参阅 配置选项 以获取更多信息。

参数

--m agent_qmgr_name

可选。 代理队列管理器的名称。 该代理必须是要取消的传输的源或目标代理。 如果未指定该参数，那么会将取消请求发送至您使用的配置选项集标识的队列管理器。

--p 配置选项

可选。 该参数确定用于取消传输的配置选项集。 按照约定，请使用非缺省协调队列管理器的名称作为该参数的输入。 然后，命令使用与此非缺省协调队列管理器相关联的属性文件集。

如果未指定该参数，那么将使用基于缺省协调队列管理器的配置选项集。

-代理名称

必需。 要取消的传输的源或目标代理的名称。

-mquserid user_id

可选。 指定要向命令队列管理器进行认证的用户标识。

-mqpassword 密码

可选。 指定通过协调队列管理器进行认证时所使用的密码。

指定 -mqpassword 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid，但未指定 -mqpassword，那么系统将提示您提供关联的密码，不会显示该密码。

从 IBM MQ 9.3 开始，该命令缺省为使用 MQCSP 认证，并将要认证的用户标识和密码发送到 MQCSP 结构中的队列管理器。

-nolpw

可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器，请指定此参数。

指定 -nolpw 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid 和 -nolpw，但未指定 -mqpassword，那么系统会提示您提供关联的密码，不会显示该密码。

注: 如果指定 -nolpw 选项，并且密码长度超过 12 个字符，那么命令将失败并返回错误消息 BFGCL0829E。

transfer_ID

必需。 要取消的传输的标识。 在发出 fteCreateTransfer 命令之后，该传输标识（也称为请求标识）将显示在命令行中。 传输标识也包含在文件传输日志消息中，或者显示在 " IBM MQ Explorer 传输日志" 面板中。

-或-h

可选。 显示命令语法。

返回码

0

命令已成功完成，或代理无法识别指定的传输标识。 如果代理无法识别该传输标识，那么最有可能的原因是该传输已完成或已取消。

1

命令结束但未成功。