![[Windows]](ngwin.gif)
fteModifyLogger(将 "MFT日志记录器作为 "Windows服务运行)
使用 fteModifyLogger 命令来修改 Managed File Transfer 记录器,以便可以将其作为 Windows 服务运行。 只能在 Windows 平台上使用此命令,必须由作为 IBM® MQ 管理员和 mqm 组成员的用户运行,并且必须首先使用 fteStopLogger 命令停止记录器。
用途
独立记录器 (无论是针对文件还是针对数据库) 在 服务 应用程序的 名称 列中显示为 Managed File Transfer 属性集 逻辑名称@logger_qm 的记录器
。 logger_qm 的值是记录器的命令队列管理器的名称。
Syntax
参数
- --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 服务日志级别。 有效选项是:error、info、warn、debug。 缺省选项为 info。 如果 Windows 服务出现问题,那么该选项可能很有用。 如果将其设置为 debug,那么会在服务日志文件中提供更详细的信息。
- -n
- 可选。 指示记录器将作为正常进程运行。 这与 -s 选项互斥。 如果既未指定 -s 选项也未指定 -n 选项,那么会将记录器配置为标准的 Windows 进程。
- -或-h
- 可选。 显示命令语法。
示例
运行 "fteModifyLogger命令前,必须使用fteStopLogger命令停止记录仪。
在该例中,先前已创建了名为 logger1 的记录器。 该命令显示如何更改记录器以作为 Windows 服务运行:fteModifyLogger -loggerName logger1 -s -su fteuser -sp ftepassword返回码
- 0
- 命令成功完成。
- 1
- 命令结束但未成功。
