Installing and configuring the IBM MQ Managed File Transfer stand-alone file logger

The stand-alone file logger is a Java process that must connect to a coordination queue manager by using IBM® MQ bindings mode or client mode. To define a stand-alone file logger use the fteCreateLogger command and follow the steps in this topic.

About this task

For more information about the stand-alone file logger, see Configuring an Managed File Transfer logger. The steps in this topic configure a logger to connect to a coordination queue manager. For alternative logger configurations see Alternative configurations for the stand-alone logger

The stand-alone file logger is not supported on z/OS® or IBM i.

Procedure

  1. Ensure that you have the IBM MQ Managed File Transfer Logger component installed. For more information, see IBM MQ Managed File Transfer product options
  2. Run the fteCreateLogger command specifying the coordination queue manager, and setting the parameter -loggerType to FILE to create your stand-alone file logger. For more information, see fteCreateLogger (create a IBM MQ Managed File Transfer logger).
  3. Optional: If you want to use a custom format then you can modify the XML file created by the fteCreateLogger command. The log format definition is located in the FileLoggerFormat.xml file. For more information, see Stand-alone file logger format.
  4. Run the MQSC commands, provided by the fteCreateLogger command, against your coordination queue manager to create the logger queues.
  5. Identify a user to run the logger process and configure permissions for that user. For more information, see Configuring user access for a stand-alone file logger.
  6. Optional: You can configure the stand-alone file logger further by editing the logger.properties file created when you ran the fteCreateLogger command. This file is a Java properties file that consists of key-value pairs. The logger.properties file is in the MQ_DATA_PATH/mqft/config/coordination_qmgr_name/loggers/logger_name directory. For more information about available properties and their affects, see Logger configuration properties for IBM MQ Managed File Transfer.
  7. Optional: If you are using a Windows system, you can run the stand-alone file logger as a Windows service. Run the fteModifyLogger command with the -s parameter. For more information, see fteModifyLogger (run a IBM MQ Managed File Transfer logging application as a Windows service).
  8. Start the stand-alone file logger with the fteStartLogger command. For more information, see fteStartLogger (start a logger).

    If you carried out the previous step and used the fteModifyLogger command with the -s parameter on Windows, the stand-alone file logger starts as a Windows service.

  9. Check the logger output. The stand-alone file logger generates two types of output, file transfer audit data and logger diagnostic data. The file transfer audit data can be found in MQ_DATA_PATH/mqft/logs/coordination_qmgr_name/loggers/logger_name/logs. The logger diagnostic data can be found in MQ_DATA_PATH/mqft/logs/coordination_qmgr_name/loggers/logger_name
  10. You can stop the logger by using the fteStopLogger command. For more information, see fteStopLogger (stop a logger).

Results