fteStartLogger
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 we 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 you 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
Parameters
- logger_name
- Required. The name of the Managed File Transfer logger you 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.