Environment variables for logging and tracing MQListener

Several environment variables control logging and tracing for MQListener. These variables are defined in the file .profile.

MQLSNTRC

When this environment variable is set to 1, MQListener writes function entry, data, and exit points to a unique HFS or zFS file. A unique trace file is generated whenever any of the MQListener commands are run. This trace file is used by IBM® Support for debugging. Do not define this variable unless IBM Support requests that you do so.

If you have enabled tracing, when the MQListener daemon is running, it writes to the trace file. Therefore, if you open the trace file while the MQListener daemon is running, you need to open it only in read mode.

MQLSNLOG

The log file contains diagnostic information about major events. This environment variable is set to the name of the file where all log information is written. All instances of the MQListener daemon running one or more tasks share the same file. For monitoring the MQListener daemon, this variable should always be set.

When the MQListener daemon is running, it writes to the log file. Therefore, if you open the log file while the MQListener daemon is running, you need to open it only in read mode.

MQLSNLWR

When MQLSNLOG specifies an HFS log file, MQLSNLWR provides the capability to limit the HFS log file size. The syntax for an MQLSNLWR export command is:

export MQLSNLWR=file-size,file-name

The meanings of the variables are:

file-size: The maximum size of the MQListener log file, in megabytes.
file-name: The name of the HFS file into which MQListener saves a copy of the MQListener log file.

When MQLSNLWR is specified, and the MQListener HFS log file reaches file-size, MQListener saves a copy of the log file named file-name, and reinitializes the HFS log file.

Important: The ID under which MQListener runs must have write access to the HFS log file and to the copy of the HFS log file that is specified by file-name. If MQListener cannot open or write to the copy of the HFS log file, MQListener reinitializes the HFS log file, but does not create a copy.

Refer to the README file for more details about these variables.