Enabling Tracing When Using WebSphere MQ Version 7
When using WebSphere MQ version 7, use the following procedure to enable tracing.
![*](icon_task_xpe.png)
To enable a trace when using WebSphere MQ version 7
1. Using a text editor, create a property file.
The recommended values for each property are as follows:
Property | Description | Recommended Value |
Diagnostic.MQ | Controls use of WebSphere MQ-level tracing. Valid values: enabled Displays trace messages. disabled Does not trace messages. Default: disabled | enabled |
Diagnostics.Java | Specifies which components are traced using Java trace. Valid values: explorer Diagnostics from WebSphere MQ Explorer. soap Diagnostics from the running process within WebSphere MQ Transport for SOAP. wmqjavaclasses Diagnostics from the underlying WebSphere MQ Java classes. Default: No components are traced. | soap, wmqjavaclasses |
Diagnostics.Java.Trace.Detail | Specifies detail level for Java trace. Valid values: high Provides a high level of detail for the trace. medium Provides a moderate level of detail for the trace. low Provides a low level of detail for the trace. This option is unique to Java trace. Default: medium | high |
Diagnostics.Java.Trace.Destination.File | Specifies whether Java trace is written to a file. Valid values: enabled Writes java trace to a file. disabled Does not write java trace to a file. Default: disabled | enabled |
Diagnostics.Java.Trace.Destination.Console | Specifies whether Java trace is written to the system console. Valid values: enabled Writes java trace to system console. disabled Does not write java trace to system console. Default: disabled | enabled |
Diagnostics.Java.Trace.Destination.Pathname | Specifies the directory to which Java trace is written. | c:\\tracedir |
Diagnostics.Java.FFDC.Destination.Pathname | Specifies the directory to which Java FFDC output is written. | c:\\errorsdir |
2. Save the property file anywhere you choose, but make sure the correct path is provided in the server.bat file.
3. Open the server.bat file located in the Integration Server_directory \bin\server.bat directory in a text editor.
4. Add the Dcom.ibm.mq.commonservices java system property for the JAVA_RUN environment variable as follows:
%JAVA_RUN%-Dcom.ibm.mq.commonservices=file_location
where file_location is the location of the property file created in step 1.
For example, %JAVA_RUN% -Dcom.ibm.mq.commonservices=”d:/mq7.txt”
After restarting the server, MQ trace will be available under the location specified in the Diagnostics.Java.Trace.Destination.Pathname property with the format AMQyyyymmddhhmmsssss.*.TRC.