fteModifyLogger(作为 Windows 服务运行IBM MQ Managed File Transfer日志应用程序)

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

用途

独立记录器 (无论是针对文件还是针对数据库) 在 服务 应用程序的 名称 列中显示为 IBM MQ 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)
必需。 要修改的 IBM MQ Managed File Transfer 记录器的名称。

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

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

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

服务的显示名称 (在 Windows 服务 窗口的 名称 列中显示) 始终为 WebSphere MQ Managed File Transfer 记录器 <LOGGER>@<QMGR>

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

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

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

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

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

[V8.0.0.9 2018 年 3 月]有关 fteModifyLogger 命令处理通过 -serviceJVMOptions 参数指定的 JVM 选项更新验证的方式的更多信息,请参阅 更新代理程序或记录器 JVM 选项指南

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

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

-? or -h
可选。 显示命令语法。

示例

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

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

返回码

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