Tracepoint specification

You enable tracepoints by specifying component and tracepoint.

If no qualifier parameters are entered, all tracepoints are enabled, except for exception.output trace, where the default is all {exception}.

The <tracepoint_specification> is as follows:
[!]<component>[{<type>}] or [!]<tracepoint_id>[,...]
where:
!
is a logical not. That is, the tracepoints that are specified immediately following the ! are turned off.
<component>
is one of:
  • all
  • The JVM subcomponent (that is, dg, j9trc, j9vm, j9mm, j9bcu, j9vrb, j9shr, j9prt, java,awt, awt_dnd_datatransfer, audio, mt, fontmanager, net, awt_java2d, awt_print, or nio)
<type>
is the tracepoint type or group. The following types are supported:
  • Entry
  • Exit
  • Event
  • Exception
  • Mem
  • A group of tracepoints that have been specified by use of a group name. For example, nativeMethods select the group of tracepoints in MT (Method Trace) that relate to native methods. The following groups are supported:
    • compiledMethods
    • nativeMethods
    • staticMethods
<tracepoint_id>
is the tracepoint identifier. This constitutes the component name of the tracepoint, followed by its integer number inside that component. For example, j9mm.49, j9shr.20-29, j9vm.15, To understand these numbers, see Determining the tracepoint ID of a tracepoint.
Some tracepoints can be both an exit and an exception; that is, the function ended with an error. If you specify either exit or exception, these tracepoints will be included.
The following tracepoint specification used in Java™ 5.0 and earlier IBM® SDKs is still supported:
[!]tpnid{<tracepoint_id>[,...]}

Examples



© Copyright IBM Corporation 2005, 2010. All Rights Reserved.
© Copyright Sun Microsystems, Inc. 1997, 2007, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This information center is powered by Eclipse technology. (http://www.eclipse.org/)