fteStartLogger (start a logger)
The fteStartLogger command starts a IBM® MQ 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 Configuring an Managed File Transfer logger. For IBM WebSphere® MQ V7.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 a IBM WebSphere MQ administrator you 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 you want to use a set of configuration options different from the default. For more information on logger properties, see Logger configuration properties for IBM MQ Managed File Transfer
Syntax
Parameters
- logger_name
- Required. The name of the IBM MQ Managed File Transfer logger you want to start.
- -pconfiguration_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 you 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 you 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.