Home

 

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 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 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 filename 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.

 

Parent topic:

Java diagnostics

fa15470_

 

Home