[Windows]

fteModifyLogger(将 "MFT日志记录器作为 "Windows服务运行)

使用 fteModifyLogger 命令来修改 Managed File Transfer 记录器,以便可以将其作为 Windows 服务运行。 只能在 Windows 平台上使用此命令,必须由作为 IBM® MQ 管理员和 mqm 组成员的用户运行,并且必须首先使用 fteStopLogger 命令停止记录器。

用途

独立记录器 (无论是针对文件还是针对数据库) 在 服务 应用程序的 名称 列中显示为 Managed File Transfer 属性集 逻辑名称@logger_qm 的记录器logger_qm 的值是记录器的命令队列管理器的名称。

Syntax

fteModifyLogger

Read syntax diagramSkip visual syntax diagramfteModifyLogger-loggerName (logger_name) -p configuration_ options-n-s service_nameWindows systems options
Windows system options
Read syntax diagramSkip visual syntax diagram-su user_name -sp password-sj options-sl options

参数

--loggerName(logger_name)
必需。 要修改的 Managed File Transfer 记录器的名称。

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

仅在您希望使用不同于缺省值的配置选项时,才指定可选的 -p 参数。 如果未指定该参数,那么将使用基于缺省协调队列管理器的配置选项集。

-服务名称
可选。 指示记录器将作为 Windows 服务运行。 如果未指定 service_name,那么服务将命名为 mqmftLoggerLOGGERQMGR,其中 LOGGER 是记录器名称,而 QMGR 是记录器队列管理器名称。

服务的显示名称 (显示在 " Windows 服务 " 窗口的 名称 列中) 始终为 Managed File Transfer Logger LOGGER@QMGR

-su 用户名
当指定 -s 时必需。 指定运行 Windows 服务所使用的帐户名。 要使用 Windows 域用户帐户运行代理程序,请以 DomainName\UserName格式指定值。 要使用本地内置域中的帐户来运行该服务,请以 UserName 格式指定该值。

您使用 -su 参数指定的 Windows 用户帐户必须具有作为服务登录的许可权。 有关如何授予此许可权的信息,请参阅 有关将 MFT 代理程序或记录器作为 Windows 服务运行的指南

-sp 密码
可选。 仅当指定 -s 时才有效。 -su 参数设置的用户帐户的密码。

如果未指定该参数,那么当指定 -s 参数时,系统将警告您必须首先使用 Windows 服务工具设置密码,然后服务才能成功启动。

-sj 选项
可选。 仅当指定 -s 时才有效。 当日志记录器作为 "Windows服务启动时,该参数将以-D或-X的形式定义一系列选项,这些选项将传递给 JVM。 系统会使用数字符号 (#) 或分号 (;) 字符分隔这些选项。 如果需要嵌入任何 # 或 ; 字符,请使用单引号 (') 将其括起。

有关 fteModifyLogger 命令处理 JVM 选项更新验证的方式的更多信息,请参阅 有关更新代理程序或记录器 JVM 选项的指导信息

-sl 选项
可选。 仅当指定 -s 时才有效。 设置 Windows 服务日志级别。 有效选项是:errorinfowarndebug。 缺省选项为 info。 如果 Windows 服务出现问题,那么该选项可能很有用。 如果将其设置为 debug,那么会在服务日志文件中提供更详细的信息。

-n
可选。 指示记录器将作为正常进程运行。 这与 -s 选项互斥。 如果既未指定 -s 选项也未指定 -n 选项,那么会将记录器配置为标准的 Windows 进程。

-或-h
可选。 显示命令语法。

示例

运行 "fteModifyLogger命令前,必须使用fteStopLogger命令停止记录仪。

在该例中,先前已创建了名为 logger1 的记录器。 该命令显示如何更改记录器以作为 Windows 服务运行:
fteModifyLogger -loggerName logger1 -s -su fteuser -sp ftepassword

返回码

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