WebSphere MQ Adapter 6.5 | webMethods WebSphere MQ Adapter Documentation | webMethods WebSphere MQ Adapter Installation and User’s Guide Documentation | Logging and Exception Handling | Enabling Tracing When Using WebSphere MQ Version 7
 
Enabling Tracing When Using WebSphere MQ Version 7
When using WebSphere MQ version 7, use the following procedure to enable tracing.
*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.