fteModifyAgent（将 "MFT代理作为 "Windows服务运行）

fteModifyAgent 命令可修改现有代理以便其能够作为 Windows 服务运行。此命令仅在 Windows上可用，并且必须由作为 IBM® MQ 管理员和 mqm 组成员的用户运行。

Syntax

fteModifyAgent

Windows system options

参数

--agentName agent_name: 必需。要修改的代理的名称。
--p 配置选项: 可选。该参数可确定用于修改代理的配置选项集。按照约定，请使用非缺省协调队列管理器的名称作为该参数的输入。然后，fteModifyAgent 命令使用与此非缺省协调队列管理器相关联的属性文件集。; 仅在您希望使用不同于缺省值的配置选项时，才指定可选的 -p 参数。如果未指定该参数，那么将使用基于缺省协调队列管理器的配置选项集。
-服务名称: 可选。指示代理程序将作为 Windows 服务运行。如果不指定 service_name，那么服务将命名为 mqmftAgentAGENTQMGR，其中 AGENT 是代理名称；而 QMGR 是代理队列管理器名称。; 服务的显示名称 (显示在 " Windows 服务 " 窗口的名称列中) 始终为 Managed File Transfer Agent AGENT@QMGR。
注: 如果可再分发代理程序将作为 Windows 服务运行，那么需要在系统环境中设置 BFG_DATA 环境变量才能使服务工作。
-su 用户名: 可选。当代理程序作为 Windows 服务运行时，该参数指定运行服务所使用的帐户名。要使用 Windows 域用户帐户运行代理程序，请以 DomainName\UserName格式指定值。要使用本地内置域中的帐户来运行该服务，请以 UserName 格式指定该值。; 您使用 -su 参数指定的 Windows 用户帐户必须具有 Log on as a service 权限。有关如何授予此权限的信息，请参阅对作为 Windows 服务运行的 MFT 代理或记录器进行故障诊断。; 当指定 -s 时，该参数为必需参数。
-sp 密码: 可选。该参数仅在指定 -s 时才有效。
-sj 选项: 可选。当代理作为 "Windows服务启动时，该参数以-D或-X的形式定义了一系列选项，这些选项将传递给 "Java虚拟机（JVM）。系统会使用数字符号 (#) 或分号 (;) 字符分隔这些选项。如果需要嵌入任何 # 或 ; 字符，请使用单引号将其引起来。; 该参数仅在指定 -s 时才有效。; 有关 fteModifyAgent 命令处理 JVM 选项更新验证的方式的更多信息，请参阅如何处理代理程序和记录器 JVM 选项。
-sl 选项: 可选。设置 Windows 服务日志级别。有效选项包括：error、info、warn 和 debug。缺省值为 info。如果 Windows 服务出现问题，那么该选项可能很有用。如果将其设置为 debug，那么会在服务日志文件中提供更详细的信息。; 该参数仅在指定 -s 时才有效。
-n: 可选。指示代理将作为正常进程运行。这与 -s 选项互斥。如果既未指定 -s 选项也未指定 -n 选项，那么会将代理配置为标准的 Windows 进程。
-或-h: 可选。显示命令语法。

示例

在该例中，AGENT1 被修改以作为 Windows 服务运行：

fteModifyAgent -agentName AGENT1 -s Service1 -su fteuser -sp ftepassword

在此示例中，修改 AGENT1 以便除去其 Windows 服务：

fteModifyAgent -agentName AGENT1

必须先使用 "fteStopAgent命令停止要修改的代理，然后才能运行 "fteModifyAgent命令。

返回码

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