fteStartLogger: start an MFT logger

The fteStartLogger command starts a Managed File Transfer logging application.


Purpose

Use the fteStartLogger command to start a logger. The logger can be either a file or database application that runs on the same system as the coordination queue manager. For more information, see the topic Configure an MFT logger. For IBM WebSphere MQ Version 7.5, or later, the logger process controller manages starting the logger. However, the logger process controller may wait for a period of time, for example where there have been a high rate of logger failures, before attempting to start the logger again. As an IBM MQ administrator we can use the fteStartLogger command to override this wait and initiate a start of the logger. If the logger process controller was waiting for the queue manager to become available this command will also initiate the logger process controller attempting to reconnect to the queue manager.

If you have configured a logger to run as a Windows service by using the fteModifyLogger command, running the fteStartLogger command starts the Windows service.

This command returns an error if the logger does not start or is already started. The logger communicates with its queue manager based on the values defined in the logger.properties file.

Specify the -p parameter for this command only if we want to use a set of configuration options different from the default. For more information on logger properties, see MFT logger configuration properties


Syntax

fteStartLogger

fteStartLogger-p configuration_options-F  logger_name ?


Parameters

    logger_name
    Required. The name of the Managed File Transfer logger we want to start.

    -p configuration_options
    Optional. This parameter determines the set of configuration options that is used to issue the request to start a logger. Use the name of a non-default coordination queue manager as the input for this parameter. fteStartLogger then uses the set of properties files associated with this non-default coordination queue manager.

    If we do not specify this parameter, the set of configuration options based on the default coordination queue manager is used.

    -F
    Optional. Runs the logger as a foreground process (rather than as the default background process). If we have configured the logger to run as a Windows service by using the fteModifyLogger command, the -F parameter overrides this configuration.

    -? or -h
    Optional. Displays command syntax.


Example

In this example, a logger has previously been created named logger1. This command shows how the logger can be started as a foreground process:
fteStartLogger -F logger1


Return codes

    0
    Command completed successfully.

    1
    Command ended unsuccessfully.

Parent topic: MFT commands


Related reference


Related information