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 loggerThe stand-alone file logger is not supported
on z/OS® or IBM i.
Procedure
- Ensure that you have the IBM MQ Managed File Transfer Logger component installed.
For more information, see IBM MQ Managed File Transfer product options
- 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).
- 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.
- Run the MQSC commands, provided by the fteCreateLogger command,
against your coordination queue manager to create the logger queues.
- 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.
- 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.
- 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).
- 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.
- 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
- You can stop the logger by using the fteStopLogger command.
For more information, see fteStopLogger (stop a logger).