fteDeleteLogger

Use the fteDeleteLogger command to delete a Managed File Transfer logger and its configuration. Existing log files associated with the logger can either be retained or deleted.

Important: On IBM MQ for Multiplatforms, only users who are IBM MQ administrators (and members of the mqm group) can run this command. If you try to run this command as a user who is not an IBM MQ administrator, you will receive the error message BFGCL0502E: You are not authorized to perform the requested operation. and the command will not run. On z/OS® systems, the user must satisfy (at least) one of these conditions in order to run the migrate command:

• Be a member of the mqm group (if the mqm group is defined on the system).
• Be a member of the group named in the BFG_GROUP_NAME environment variable (if one is named).
• Have no value set in the BFG_GROUP_NAME environment variable when the command is run.

Purpose

Stop the logger with the fteStopLogger command before running the fteDeleteLogger command.

If we have configured your logger to run as a Windows service, running the fteDeleteLogger command deletes the service definition.

The logger configuration directory contains a MQSC script to delete the queues and the subscription for the logger. These queues are as follows:

• SYSTEM.FTE.LOG.CMD.logger_name
• SYSTEM.FTE.LOG.RJCT.logger_name

The subscription name is as follows:

• SYSTEM.FTE.AUTO.SUB.logger_name

The MQSC script can be found at MQ_DATA_PATH\mqft\config\coordination_qmgr\loggers\logger_name\logger_name_delete.mqsc

Syntax

fteDeleteLogger

 -f

 loggerName

Parameters

-p (configuration_ options)

Optional. Determines the set of configuration options that is used to start the stand-alone database logger. Use the name of a set of configuration options as the value for the -p parameter. By convention this value is the name of a coordination queue manager. If we do not specify this parameter, the default set of configuration options is used.

-f

Optional. Forces the removal of any log files created by this logger. If this parameter is omitted, any log files created by the logger will be retained, and must be manually removed when they are no longer required.

logger_name

Required. The name of the logger to delete.

-? or -h

Optional. Displays command syntax.

Example

In this example, a logger called logger1 is deleted. The -f parameter has been specified, which causes the logger's log files to be removed as well as the logger's configuration files.

fteDeleteLogger -f logger1

Return codes

0

Command completed successfully.

1

Command ended unsuccessfully.