Use com.ibm.mq.commonservices

The com.ibm.mq.commonservices properties file contains the following entries relating to the output of diagnostics from the Java components of IBM MQ .

Note that case is significant in all these entries:

    Diagnostics.Java= options
    Which components are traced using Java trace. Options are one or more of explorer, soap, and wmqjavaclasses, separated by commas, where "explorer" refers to the diagnostics from the IBM MQ Explorer, "soap" refers to the diagnostics from the running process within IBM MQ Transport for SOAP, and "wmqjavaclasses" refers to the diagnostics from the underlying IBM MQ Java classes. By default no components are traced.

    Diagnostics.Java.Trace.Detail= high|medium|low
    Detail level for Java trace. The high and medium detail levels match those used in IBM MQ tracing but low is unique to Java trace. This property is ignored if Diagnostics.Java is not set. The default is medium.

    Diagnostics.Java.Trace.Destination.File= enabled|disabled
    Whether Java trace is written to a file. This property is ignored if Diagnostics.Java is not set. The default is disabled.

    Diagnostics.Java.Trace.Destination.Console= enabled|disabled
    Whether Java trace is written to the system console. This property is ignored if Diagnostics.Java is not set. The default is disabled.

    Diagnostics.Java.Trace.Destination.Pathname= dirname
    The directory to which Java trace is written. This property is ignored if Diagnostics.Java is not set or Diagnostics.Java.Trace.Destination.File=disabled. On UNIX and Linux systems, the default is /var/mqm/trace if it is present, otherwise the Java console (System.err). On Windows, the default is the system console.

    Diagnostics.Java.FFDC.Destination.Pathname= dirname
    The directory to which Java FFDC output is written. The default is the current working directory.

    Diagnostics.Java.Errors.Destination.Filename= filename
    The fully qualified file name to which Java error messages are written. The default is AMQJAVA.LOG in the current working directory.

An example of a com.ibm.mq.commonservices properties file is given in Figure 1. Lines beginning with the number sign (#) are treated as comments.

Figure 1. Sample com.ibm.mq.commonservices properties file
#
# Diagnostics for MQ Explorer are enabled
#
Diagnostics.wmqexplorer
#
# High detail Java trace
#
Diagnostics.Java.Trace.Detail=high
#
# Java trace is written to a file and not to the console.
#
Diagnostics.Java.Trace.Destination.File=enabled
Diagnostics.Java.Trace.Destination.Console=disabled
#
# Directory for Java trace file
#
Diagnostics.Java.Trace.Destination.Pathname=c:\\tracedir
#
# Directory for First Failure Data Capture
#
Diagnostics.Java.FFDC.Destination.Pathname=c:\\ffdcdir
#
# Directory for error logging
#
Diagnostics.Java.Errors.Destination.Filename=c:\\errorsdir\\SOAPERRORS.LOG
#
Parent topic: Tracing additional IBM MQ Java components