fteDeleteAgent（删除 "MFT代理及其配置）

fteDeleteAgent 命令将删除 Managed File Transfer Agent 及其配置。 如果该代理是协议网桥代理，那么用户凭证文件将留在文件系统上。

用途

在运行 "fteDeleteAgent命令前，使用fteStopAgent 命令停止代理。

如果您已将代理配置为作为 Windows 服务运行，那么运行 fteDeleteAgent 命令将删除服务定义。

从 IBM® MQ 9.1开始，删除代理时将除去任何资源监视器和调度的传输。

只有作为 IBM MQ 管理员 (以及 mqm 组的成员) 的用户才能运行此命令。 如果尝试以非 IBM MQ 管理员的用户身份运行此命令，那么您将接收到错误消息，并且该命令将不会运行。

fteDeleteAgent 命令向您提供 MQSC 命令，您必须针对代理的队列管理器运行这些命令以清除和删除代理的系统队列。 这些队列如下所示：
  • SYSTEM.FTE.AUTHADM1.代理名称
  • SYSTEM.FTE.AUTHAGT1.代理名称
  • SYSTEM.FTE.AUTHMON1.代理名称
  • SYSTEM.FTE.AUTHOPS1.代理名称
  • SYSTEM.FTE.AUTHSCH1.代理名称
  • SYSTEM.FTE.AUTHTRN1.代理名称
  • SYSTEM.FTE.COMMAND。代理名称
  • SYSTEM.FTE.DATA.agent_name
  • SYSTEM.FTE.EVENT。代理名称
  • SYSTEM.FTE.REPLY。代理名称
  • SYSTEM.FTE.STATE.代理名称
fteCreateAgent 命令还在以下位置的文件中提供这些命令：
MQ_DATA_PATH/mqft/config/coordination_qmgr_name/agents/agent_name/agent_name_delete.mqsc

Syntax

fteDeleteAgent

Read syntax diagramSkip visual syntax diagramfteDeleteAgent-p configuration_options -f-mquseriduser_id-nolpw-mqpasswordpassword-nolpwagent_name

参数

--p 配置选项
可选。 如果有多个协调队列管理器，请使用此参数来显式指定希望删除哪个代理配置。 使用非缺省协调队列管理器的名称作为该参数的输入。 然后，该命令将使用与该非缺省协调队列管理器关联的配置选项。
仅在您希望使用不同于缺省值的配置选项时，才指定可选的 -p 参数。 如果未指定 -p，那么将使用 installation.properties 文件中定义的配置选项。 请参阅 配置选项 以获取更多信息。
-f
可选。 强制该命令从协调队列管理器注销该代理，即使找不到该代理的配置文件也是如此。 由于在此情况下，该代理的队列管理器的相关信息不可用，因此该命令将直接连接到协调队列管理器，而不是像通常那样使用代理队列管理器。
-mquserid 用户ID
可选。 指定通过代理队列管理器进行认证时所使用的用户标识，除非存在 -f 强制参数。 如果存在 -f 参数，将会指定通过协调队列管理器进行认证时所需的用户标识。
-mqpassword 密码
可选。 指定通过协调队列管理器进行认证时所使用的密码。
指定 -mqpassword 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid，但未指定 -mqpassword，那么系统将提示您提供关联的密码，不会显示该密码。

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

[MQ 9.3.0 2022 年 6 月][MQ 9.3.0 2022 年 6 月]-nolpw
可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器，请指定此参数。
指定 -nolpw 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid 和 -nolpw，但未指定 -mqpassword，那么系统会提示您提供关联的密码，不会显示该密码。
注: 如果指定 -nolpw 选项，并且密码长度超过 12 个字符，那么命令将失败并返回错误消息 BFGCL0829E。
agent_name
必需。 要删除的代理的名称。
-或-h
可选。 显示命令语法。

示例

在此示例中，将在协调队列管理器 QM_COORD1 上删除 AGENT3 及其配置：
fteDeleteAgent -p QM_COORD1 AGENT3
此示例命令输出以下 MQSC 命令，用于删除该代理的三个队列：
CLEAR QLOCAL(SYSTEM.FTE.COMMAND.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.COMMAND.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.DATA.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.DATA.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.REPLY.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.REPLY.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.STATE.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.STATE.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.EVENT.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.EVENT.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHADM1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHADM1.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHAGT1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHAGT1.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHTRN1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHTRN1.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHOPS1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHOPS1.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHSCH1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHSCH1.AGENT3)
CLEAR QLOCAL(SYSTEM.FTE.AUTHMON1.AGENT3)
DELETE QLOCAL(SYSTEM.FTE.AUTHMON1.AGENT3)

返回码

0
命令成功完成。
1
命令结束但未成功。