filter option

Some JVM events occur thousands of times during the lifetime of an application. Dump agents can use filters and ranges to avoid excessive dumps being produced.

Wildcards

You can use a wildcard in your exception event filter by placing an asterisk only at the beginning or end of the filter. The following command does not work because the second asterisk is not at the end:
-Xdump:java:events=vmstop,filter=*InvalidArgumentException#*.myVirtualMethod
In order to make this filter work, it must be changed to:
-Xdump:java:events=vmstop,filter=*InvalidArgumentException#MyApplication.*

Class loading and exception events

You can filter class loading (load) and exception (throw, catch, uncaught, systhrow) events by Java™ class name:

-Xdump:java:events=throw,filter=java/lang/OutOfMem*
-Xdump:java:events=throw,filter=*MemoryError
-Xdump:java:events=throw,filter=*Memory*

From Java 6 SR 3, you can filter throw, uncaught, and systhrow exception events by Java method name:

-Xdump:java:events=throw,filter=ExceptionClassName[#ThrowingClassName.throwingMethodName[#stackFrameOffset]]

Optional portions are shown in square brackets.

From Java 6 SR 3, you can filter the catch exception events by Java method name:
-Xdump:java:events=catch,filter=ExceptionClassName[#CatchingClassName.catchingMethodName]

Optional portions are shown in square brackets.

vmstop event

You can filter the JVM shut down event by using one or more exit codes:
-Xdump:java:events=vmstop,filter=#129..192#-42#255

slow event

You can filter the slow event to change the time threshold from the default of 5 ms:

-Xdump:java:events=slow,filter=#300ms

You cannot set the filter to a time lower than the default time.

Other events

If you apply a filter to an event that does not support filtering, the filter is ignored.



© 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/)