fteModifyLogger(作为 Windows 服务运行IBM MQ Managed File Transfer日志应用程序)
使用 fteModifyLogger 命令来修改记录器,以便可以将其作为 Windows 服务运行。 只能在 Windows 平台上使用此命令,必须由作为 IBM® MQ 管理员和 mqm 组成员的用户运行,并且必须首先使用 fteStopLogger 命令来停止记录器。
用途
独立记录器 (无论是针对文件还是针对数据库) 在 服务 应用程序的 名称 列中显示为 IBM MQ Managed File Transfer 属性集 逻辑名称@logger_qm 的记录器
。 logger_qm 的值是记录器的命令队列管理器的名称。
Syntax
参数
- -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 的选项列表。 系统会使用数字符号 (#) 或分号 (;) 字符分隔这些选项。 如果需要嵌入任何 # 或 ; 字符,请使用单引号 (') 将其括起。
有关 fteModifyLogger 命令处理通过 -serviceJVMOptions 参数指定的 JVM 选项更新验证的方式的更多信息,请参阅 更新代理程序或记录器 JVM 选项指南。 - -sl 或 -serviceLogLevel选项
- 可选。 仅当指定 -s 时才有效。 设置 Windows 服务日志级别。 有效选项是:error、info、warn、debug。 缺省选项为 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
- 命令结束但未成功。
