Using 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 WebSphere® MQ.

Note that case is significant in all these entries:
Diagnostics.MQ=enabled|disabled
Are WebSphere MQ diagnostics to be used? If Diagnostics.MQ is enabled, diagnostic output is as for other WebSphere MQ components; trace output is controlled by the parameters in the strmqtrc and endmqtrc control commands, or the equivalent. The default is enabled.
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 WebSphere MQ Explorer, "soap" refers to the diagnostics from the running process within WebSphere MQ Transport for SOAP, and "wmqjavaclasses" refers to the diagnostics from the underlying WebSphere 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 WebSphere 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

#
# Base WebSphere MQ diagnostics are disabled 
#
Diagnostics.MQ=disabled  
#
# Java diagnostics for WebSphere MQ Transport for SOAP 
# and the WebSphere MQ Java Classes are both enabled
# 
Diagnostics.Java=soap,wmqjavaclasses
#
# 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 
#

A sample properties file, WMQSoap_RAS.properties, is also supplied as part of the "Java messaging and SOAP transport" install option.