By using a variant of the runwithtrace command, you can collect trace
from an instance of IBM® MQ Explorer that is installed into
your own Eclipse environment or Eclipse-based product.
Before you begin
This task assumes that you have installed IBM MQ Explorer
into your own Eclipse environment or Eclipse-based product, and therefore cannot use the standard
runwithtrace command as described in Collecting IBM MQ Explorer trace.
About this task
IBM MQ Explorer can be installed into your own Eclipse
environment or Eclipse-based product to help develop Java applications, or to develop your own extensions.
To collect trace, you use a runwithtrace command to start IBM MQ Explorer. You cannot use the runwithtrace
command that is supplied with the product. Instead, you use a variant of the command, as described
in the following procedure.
Note: You normally enable tracing only when asked to do so by your IBM Service Representative. Tracing slows down IBM MQ Explorer and the trace files can rapidly become large.
Procedure
-
The IBM MQ Explorer trace mechanism relies on AspectJ and
Equinox Weaving plug-ins being installed. To confirm that they are installed:
-
Click Help
-
Click About...
-
Click Installation Details
-
Click the Plug-ins tab.
The org.eclipse.equinox.weaving.caching.j9
plug-in no longer
exists, but you require this plug-in if you are using IBM MQ 9.0
Long Term Support, or IBM MQ 9.0
Continuous Delivery releases, prior to IBM MQ 9.0.4.
Verify that the following plug-ins are installed:
org.aspectj.runtime
org.aspectj.weaver
org.eclipse.equinox.weaving.aspectj
org.eclipse.equinox.weaving.caching
org.eclipse.equinox.weaving.caching.j9
org.eclipse.equinox.weaving.hook
-
If they are not already installed, install the AspectJ and Equinox Weaving plug-ins. These
plugins must match the version of Eclipse you are using and can be downloaded from the Eclipse
AspectJ Development Tools download site. To determine which download site to use for your version of
Eclipse, see https://projects.eclipse.org/projects/tools.ajdt.
To install the AspectJ and Equinox Weaving plug-ins, complete the following substeps:
-
Click Help then click Install New
Software...
-
Click Add... then enter the location of the download site appropriate
for the Eclipse version.
For example, for Eclipse 4.4, enter
https://download.eclipse.org/tools/ajdt/44/dev/update.
-
Click OK
A list of available software is displayed.
-
Expand the Other AJDT Tools (Optional) category and select
AspectJ Compiler and Equinox Weaving SDK.
-
Click Next and follow the wizard instructions.
-
Trace IBM MQ Explorer.
When you start the IBM MQ Explorer by using the
runwithtrace command, extra parameters are incorporated that enable tracing of
IBM MQ Explorer. Note the runwithtrace
command takes no parameters itself.
The output location of the trace file is printed to the command line when the command runs
because the actual location is dependent upon
- the status of the IBM MQ installation.
- the user permissions.
The IBM MQ Explorer trace files have
a name of the format AMQYYYYMMDDHHmmssmmm.TRC.n that indicates the start time
of the trace session. When a trace file reaches its maximum size, the trace facility renames all
trace files from the session by incrementing the file suffix .n by one. The
trace facility then creates a new file with the suffix .0 that contains the
latest trace.
-
Uninstall the AspectJ and Equinox Weaving plug-ins. When you finish with IBM MQ Explorer trace, you can remove the AspectJ and Equinox Weaving
plugins from the Eclipse environment. To uninstall AspectJ and Equinox Weaving plug-ins:
-
Click Help and then click About....
-
Click Installation Details and then click the Installed
Software tab.
-
Select the items AspectJ Complier and Equinox Weaving
SDK.
-
Click Uninstall... and follow the wizard instructions.