[UNIX、Linux、Windows][z/OS]

fteDeleteLogger(删除MFT日志记录器及其配置)

使用 fteDeleteLogger 命令可删除 Managed File Transfer 记录器及其配置。 可以保留或删除与该记录器关联的现有日志文件。

重要说明:
[AIX、Linux 和 Windows]AIX®, Linux®, and Windows 系统上,如果您使用的是 IBM® MQ 服务器安装镜像,则必须同时满足以下两个条件才能运行该命令:
  • 成为 IBM MQ 管理员。
  • 是 mqm 组的成员(如果在系统上定义了 mqm 组)。
否则,您将收到错误信息BFGCL0502E: You are not authorized to perform the requested operation。如果您使用的是 Redistributable Managed File Transfer Agent 存档,则不受此限制。
[z/OS]z/OS® 系统上,您必须满足以下条件中的至少一项才能运行该命令:
  • 是 mqm 组的成员(如果在系统上定义了 mqm 组)。
  • 成为 BFG_GROUP_NAME环境变量 (如果有)中指定的组成员。
  • 运行命令时 ,BFG_GROUP_NAME环境变量中没有设置任何值。
[IBM i]

IBM i 上的记录器

IBM i 平台上不支持 Managed File Transfer 记录器。

用途

在运行 fteDeleteLogger 命令之前,使用 fteStopLogger 命令停止该记录器。

如果您已将记录器配置为作为 Windows 服务运行,那么运行 fteDeleteLogger 命令将删除服务定义。

记录器配置目录包含用于删除记录器的队列和预订的 MQSC 脚本。 这些队列如下所示:
  • SYSTEM.FTE.LOG.CMD.logger_name
  • SYSTEM.FTE.LOG.RJCT.logger_name
预订名称如下所示:
  • SYSTEM.FTE.AUTO.SUB。logger_name

MQSC 脚本可在 MQ_DATA_PATH\mqft\config\coordination_qmgr\loggers\logger_name\logger_name_delete.mqsc 中找到

Syntax

fteDeleteLogger

Read syntax diagramSkip visual syntax diagramfteDeleteLogger -p configuration_options -f  logger_name

参数

--p 配置选项
可选。 确定用于启动独立数据库记录器的一组配置选项。 使用一组配置选项的名称作为 -p 参数的值。 按照约定,该值是协调队列管理器的名称。 如果未指定该参数,那么会使用缺省的配置选项集。
-f
可选。 强制除去此记录器创建的任何日志文件。 如果省略此参数,那么将保留由记录器创建的任何日志文件,当不再需要这些日志文件时,必须手工将其除去。
logger_name
必需。 要删除的记录器的名称。
-或-h
可选。 显示命令语法。

示例

在此示例中,将删除称为 logger1 的记录器。 已指定 -f 参数,该参数将除去记录器的日志文件以及记录器的配置文件。
fteDeleteLogger -f logger1

返回码

表 1. 返回代码标识符和描述
返回码 描述
0 命令成功完成
1 命令未成功执行