<!--
* Copyright (c) 2017, 2020 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->


<!DOCTYPE html>
<html lang="en" class="no-js">
  <head>
    
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width,initial-scale=1">
      <meta http-equiv="x-ua-compatible" content="ie=edge">
      
        <meta name="description" content="Eclipse OpenJ9 documentation">
      
      
        <link rel="canonical" href="https://www.eclipse.org/openj9/docs/xtrace/">
      
      
        <meta name="lang:clipboard.copy" content="">
      
        <meta name="lang:clipboard.copied" content="">
      
        <meta name="lang:search.language" content="">
      
        <meta name="lang:search.pipeline.stopwords" content="">
      
        <meta name="lang:search.pipeline.trimmer" content="">
      
        <meta name="lang:search.result.none" content="">
      
        <meta name="lang:search.result.one" content="">
      
        <meta name="lang:search.result.other" content="">
      
        <meta name="lang:search.tokenizer" content="">
      
      <link rel="shortcut icon" href="../cr/oj9logo_img9.ico">
      <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-3.0.4">
    
    
        <title>-Xtrace -  </title>
      
    
      <link rel="stylesheet" href="../assets/stylesheets/application.1b62728e.css">
      
        <link rel="stylesheet" href="../assets/stylesheets/application-palette.a8b3c06d.css">
      
      
        <meta name="theme-color" content="#00bcd4">
      
    
      <script src="../assets/javascripts/modernizr.268332fc.js"></script>
    
    
        <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono">
        <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
      
    
    <link rel="stylesheet" href="../assets/fonts/material-icons.css">
    
      <link rel="stylesheet" href="../stylesheets/oj9.css">
    
    
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f (https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore%28j,f) );
})(window,document,'script','dataLayer','GTM-5WLCZXC');</script>
<!-- End Google Tag Manager -->  
  </head>
  
    
    <body dir="" data-md-color-primary="cyan" data-md-color-accent="cyan">
  
    <svg class="md-svg">
      <defs>
        
        
          <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="__github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg>
        
      </defs>
    </svg>
    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
    <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
    
      <a href="../#-xtrace" tabindex="1" class="md-skip">
        
      </a>
    
    
      <!--
* Copyright (c) 2017, 2020 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->
<header class="md-header" data-md-component="header">
    <nav class="md-header-nav md-grid">
      <div class="md-flex">
        <div class="md-flex__cell md-flex__cell--shrink">
          <a href="https://www.eclipse.org/openj9/docs" title=" " class="md-header-nav__button md-logo">
            
              <img src="../cr/openj9_6b.png">
            
          </a>
        </div>
        <div class="md-flex__cell md-flex__cell--shrink">
          <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
        </div>
        <div class="md-flex__cell md-flex__cell--stretch">
          <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
          </div>
        </div>
        <div class="md-flex__cell md-flex__cell--shrink">
          
            
              <label class="md-icon md-icon--search md-header-nav__button" for="search"></label>
              
<div class="md-search" data-md-component="search" role="dialog">
  <label class="md-search__overlay" for="__search"></label>
  <div class="md-search__inner" role="search">
    <form class="md-search__form" name="search">
      <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
      <label class="md-icon md-search__icon" for="__search"></label>
      <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
        &#xE5CD;
      </button>
    </form>
    <div class="md-search__output">
      <div class="md-search__scrollwrap" data-md-scrollfix>
        <div class="md-search-result" data-md-component="result">
          <div class="md-search-result__meta">
            
          </div>
          <ol class="md-search-result__list"></ol>
        </div>
      </div>
    </div>
  </div>
</div>
            
          
        </div>
        
          <div class="md-flex__cell md-flex__cell--shrink">
            <div class="md-header-nav__source">
              

<a href="https://github.com/eclipse/openj9-docs/" title="Go to repository" class="md-source" data-md-source="github">
  
    <div class="md-source__icon">
      <svg viewBox="0 0 24 24" width="24" height="24">
        <use xlink:href="#__github" width="24" height="24"></use>
      </svg>
    </div>
  
  <div class="md-source__repository">
    GitHub
  </div>
</a>
            </div>
          </div>
        
  
        <!-- Eclipse Incubator link -->
        <div class="md-flex__cell md-flex__cell--shrink">
          <a href="http://wiki.eclipse.org/Development_Resources/Process_Guidelines/What_is_Incubation" target="_blank"><img class="egg" src="../cr/egg-incubation.png" alt="Eclipse Incubation"></a>
        </div>  
  
      </div>
    </nav>
  </header>
  
    
    <div class="md-container">
      
        
      <main class="md-main">
        <div class="md-main__inner md-grid" data-md-component="container">
          
            
              <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    <nav class="md-nav md-nav--primary" data-md-level="0">
  <label class="md-nav__title md-nav__title--site" for="__drawer">
    <a href="https://www.eclipse.org/openj9/docs" title=" " class="md-nav__button md-logo">
      
        <img src="../cr/openj9_6b.png" width="48" height="48">
      
    </a>
     
  </label>
  
    <div class="md-nav__source">
      

<a href="https://github.com/eclipse/openj9-docs/" title="Go to repository" class="md-source" data-md-source="github">
  
    <div class="md-source__icon">
      <svg viewBox="0 0 24 24" width="24" height="24">
        <use xlink:href="#__github" width="24" height="24"></use>
      </svg>
    </div>
  
  <div class="md-source__repository">
    GitHub
  </div>
</a>
    </div>
  
  <ul class="md-nav__list" data-md-scrollfix>
    
      
  <li class="md-nav__item">
    <a href=".." title="About" class="md-nav__link">
      About
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../adoptopenjdk/" title="AdoptOpenJDK builds" class="md-nav__link">
      AdoptOpenJDK builds
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../introduction/" title="Getting started" class="md-nav__link">
      Getting started
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../openj9_newuser/" title="New to OpenJ9?" class="md-nav__link">
      New to OpenJ9?
    </a>
  </li>

    
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
    
    <label class="md-nav__link" for="nav-5">
      Release notes
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
      <label class="md-nav__title" for="nav-5">
        Release notes
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../openj9_releases/" title="Overview" class="md-nav__link">
      Overview
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.19/" title="Version 0.19.0" class="md-nav__link">
      Version 0.19.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.18/" title="Version 0.18.1" class="md-nav__link">
      Version 0.18.1
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.17/" title="Version 0.17.0" class="md-nav__link">
      Version 0.17.0
    </a>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5-5" type="checkbox" id="nav-5-5">
    
    <label class="md-nav__link" for="nav-5-5">
      Earlier releases
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-5-5">
        Earlier releases
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../version0.16/" title="Version 0.16.0" class="md-nav__link">
      Version 0.16.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.15/" title="Version 0.15.1" class="md-nav__link">
      Version 0.15.1
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.14/" title="Version 0.14.0" class="md-nav__link">
      Version 0.14.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.13/" title="Version 0.13.0" class="md-nav__link">
      Version 0.13.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.12/" title="Version 0.12.0" class="md-nav__link">
      Version 0.12.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.11/" title="Version 0.11.0" class="md-nav__link">
      Version 0.11.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.10/" title="Version 0.10.0" class="md-nav__link">
      Version 0.10.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.9/" title="Version 0.9.0" class="md-nav__link">
      Version 0.9.0
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../version0.8/" title="Version 0.8.0" class="md-nav__link">
      Version 0.8.0
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
      </ul>
    </nav>
  </li>

    
  <li class="md-nav__item">
    <a href="../gc/" title="Garbage Collection" class="md-nav__link">
      Garbage Collection
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../jit/" title="JIT Compiler" class="md-nav__link">
      JIT Compiler
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../jitserver/" title="JITServer (tech. preview)" class="md-nav__link">
      JITServer (tech. preview)
    </a>
  </li>

    
  <li class="md-nav__item">
    <a href="../aot/" title="AOT Compiler" class="md-nav__link">
      AOT Compiler
    </a>
  </li>

    
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10">
    
    <label class="md-nav__link" for="nav-10">
      Class data sharing
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
      <label class="md-nav__title" for="nav-10">
        Class data sharing
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../shrc/" title="Overview" class="md-nav__link">
      Overview
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../shrc_diag_util/" title="Diagnostic cache utilities" class="md-nav__link">
      Diagnostic cache utilities
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

    
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-11" type="checkbox" id="nav-11">
    
    <label class="md-nav__link" for="nav-11">
      Diagnostics
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
      <label class="md-nav__title" for="nav-11">
        Diagnostics
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../diag_overview/" title="Overview" class="md-nav__link">
      Overview
    </a>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-11-2" type="checkbox" id="nav-11-2">
    
    <label class="md-nav__link" for="nav-11-2">
      Dumps
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-11-2">
        Dumps
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../dump_javadump/" title="Java dump" class="md-nav__link">
      Java dump
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dump_heapdump/" title="Heap dump" class="md-nav__link">
      Heap dump
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dump_systemdump/" title="System dump" class="md-nav__link">
      System dump
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-11-3" type="checkbox" id="nav-11-3">
    
    <label class="md-nav__link" for="nav-11-3">
      Tools
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-11-3">
        Tools
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../tool_jextract/" title="Dump extractor" class="md-nav__link">
      Dump extractor
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jdmpview/" title="Dump viewer" class="md-nav__link">
      Dump viewer
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_traceformat/" title="Trace formatter" class="md-nav__link">
      Trace formatter
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_builder/" title="Option builder" class="md-nav__link">
      Option builder
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jcmd/" title="Java command (jcmd) tool" class="md-nav__link">
      Java command (jcmd) tool
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jmap/" title="Java memory map (jmap) tool" class="md-nav__link">
      Java memory map (jmap) tool
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jps/" title="Java process status (jps)" class="md-nav__link">
      Java process status (jps)
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jstack/" title="Java stack (jstack) tool" class="md-nav__link">
      Java stack (jstack) tool
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_jstat/" title="Java statistics monitoring (jstat) tool" class="md-nav__link">
      Java statistics monitoring (jstat) tool
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../tool_migration/" title="Switching to OpenJ9" class="md-nav__link">
      Switching to OpenJ9
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-11-4" type="checkbox" id="nav-11-4">
    
    <label class="md-nav__link" for="nav-11-4">
      Interfaces
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-11-4">
        Interfaces
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../interface_jvmti/" title="JVMTI" class="md-nav__link">
      JVMTI
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../interface_dtfj/" title="DTFJ" class="md-nav__link">
      DTFJ
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../interface_lang_management/" title="Language Management" class="md-nav__link">
      Language Management
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
      </ul>
    </nav>
  </li>

    
  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-12" type="checkbox" id="nav-12" checked>
    
    <label class="md-nav__link" for="nav-12">
      Command-line options
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
      <label class="md-nav__title" for="nav-12">
        Command-line options
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../cmdline_specifying/" title="Specifying options" class="md-nav__link">
      Specifying options
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../cmdline_general/" title="Standard options" class="md-nav__link">
      Standard options
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../cmdline_migration/" title="Switching to OpenJ9" class="md-nav__link">
      Switching to OpenJ9
    </a>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-12-4" type="checkbox" id="nav-12-4">
    
    <label class="md-nav__link" for="nav-12-4">
      System property options
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-12-4">
        System property options
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../d_jvm_commands/" title="Using System properties" class="md-nav__link">
      Using System properties
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmenableclasscaching/" title="-Dcom.ibm.enableClassCaching" class="md-nav__link">
      -Dcom.ibm.enableClassCaching
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmenablelegacydumpsecurity/" title="-Dcom.ibm.enableLegacyDumpSecurity" class="md-nav__link">
      -Dcom.ibm.enableLegacyDumpSecurity
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmenablelegacylogsecurity/" title="-Dcom.ibm.enableLegacyLogSecurity" class="md-nav__link">
      -Dcom.ibm.enableLegacyLogSecurity
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmenablelegacytracesecurity/" title="-Dcom.ibm.enableLegacyTraceSecurity" class="md-nav__link">
      -Dcom.ibm.enableLegacyTraceSecurity
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmgpudisable/" title="-Dcom.ibm.gpu.disable" class="md-nav__link">
      -Dcom.ibm.gpu.disable
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmgpuenable/" title="-Dcom.ibm.gpu.enable" class="md-nav__link">
      -Dcom.ibm.gpu.enable
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmgpuverbose/" title="-Dcom.ibm.gpu.verbose" class="md-nav__link">
      -Dcom.ibm.gpu.verbose
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmlangmanagementosmxbeaniscputime100ns/" title="-Dcom.ibm.lang.management.OperatingSystemMXBean.isCpuTime100ns" class="md-nav__link">
      -Dcom.ibm.lang.management.OperatingSystemMXBean.isCpuTime100ns
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmlangmanagementverbose/" title="-Dcom.ibm.lang.management.verbose" class="md-nav__link">
      -Dcom.ibm.lang.management.verbose
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmtoolsattachdirectory/" title="-Dcom.ibm.tools.attach.directory" class="md-nav__link">
      -Dcom.ibm.tools.attach.directory
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmtoolsattachdisplayname/" title="-Dcom.ibm.tools.attach.displayName" class="md-nav__link">
      -Dcom.ibm.tools.attach.displayName
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmtoolsattachenable/" title="-Dcom.ibm.tools.attach.enable" class="md-nav__link">
      -Dcom.ibm.tools.attach.enable
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmtoolsattachid/" title="-Dcom.ibm.tools.attach.id" class="md-nav__link">
      -Dcom.ibm.tools.attach.id
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dcomibmtoolsattachtimeout/" title="-Dcom.ibm.tools.attach.timeout" class="md-nav__link">
      -Dcom.ibm.tools.attach.timeout
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../dfileencoding/" title="-Dfile.encoding" class="md-nav__link">
      -Dfile.encoding
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djavacompiler/" title="-Djava.compiler" class="md-nav__link">
      -Djava.compiler
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djavalangstringsubstringnocopy/" title="-Djava.lang.string.substring.nocopy" class="md-nav__link">
      -Djava.lang.string.substring.nocopy
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djavalangstringbuffergrowaggressively/" title="-Djava.lang.stringBuffer.growAggressively" class="md-nav__link">
      -Djava.lang.stringBuffer.growAggressively
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativecbc/" title="-Djdk.nativeCBC" class="md-nav__link">
      -Djdk.nativeCBC
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativechacha20/" title="-Djdk.nativeChaCha20" class="md-nav__link">
      -Djdk.nativeChaCha20
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativecrypto/" title="-Djdk.nativeCrypto" class="md-nav__link">
      -Djdk.nativeCrypto
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativedigest/" title="-Djdk.nativeDigest" class="md-nav__link">
      -Djdk.nativeDigest
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativegcm/" title="-Djdk.nativeGCM" class="md-nav__link">
      -Djdk.nativeGCM
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../djdknativersa/" title="-Djdk.nativeRSA" class="md-nav__link">
      -Djdk.nativeRSA
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
  <li class="md-nav__item md-nav__item--active md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-12-5" type="checkbox" id="nav-12-5" checked>
    
    <label class="md-nav__link" for="nav-12-5">
      JVM -X options
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-12-5">
        JVM -X options
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../x_jvm_commands/" title="Using -X options" class="md-nav__link">
      Using -X options
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../x/" title="-X" class="md-nav__link">
      -X
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xaggressive/" title="-Xaggressive" class="md-nav__link">
      -Xaggressive
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xalwaysclassgc/" title="-Xalwaysclassgc" class="md-nav__link">
      -Xalwaysclassgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xaot/" title="-Xaot" class="md-nav__link">
      -Xaot
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xargencoding/" title="-Xargencoding" class="md-nav__link">
      -Xargencoding
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xbootclasspath/" title="-Xbootclasspath" class="md-nav__link">
      -Xbootclasspath
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xceehdlr/" title="-XCEEHDLR" class="md-nav__link">
      -XCEEHDLR
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcheck/" title="-Xcheck" class="md-nav__link">
      -Xcheck
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xclassgc/" title="-Xclassgc" class="md-nav__link">
      -Xclassgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcodecache/" title="-Xcodecache" class="md-nav__link">
      -Xcodecache
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcodecachetotal/" title="-Xcodecachetotal" class="md-nav__link">
      -Xcodecachetotal
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcomp/" title="-Xcomp" class="md-nav__link">
      -Xcomp
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompactexplicitgc/" title="-Xcompactexplicitgc" class="md-nav__link">
      -Xcompactexplicitgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompactgc/" title="-Xcompactgc" class="md-nav__link">
      -Xcompactgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompilationthreads/" title="-XcompilationThreads" class="md-nav__link">
      -XcompilationThreads
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompressedrefs/" title="-Xcompressedrefs" class="md-nav__link">
      -Xcompressedrefs
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xconcurrentbackground/" title="-Xconcurrentbackground" class="md-nav__link">
      -Xconcurrentbackground
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xconcurrentlevel/" title="-Xconcurrentlevel" class="md-nav__link">
      -Xconcurrentlevel
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xconcurrentslack/" title="-Xconcurrentslack" class="md-nav__link">
      -Xconcurrentslack
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xconmeter/" title="-Xconmeter" class="md-nav__link">
      -Xconmeter
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenableexcessivegc/" title="-Xdisableexcessivegc" class="md-nav__link">
      -Xdisableexcessivegc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenableexplicitgc/" title="-Xdisableexplicitgc" class="md-nav__link">
      -Xdisableexplicitgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xdisablejavadump/" title="-Xdisablejavadump" class="md-nav__link">
      -Xdisablejavadump
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenablestringconstantgc/" title="-Xdisablestringconstantgc" class="md-nav__link">
      -Xdisablestringconstantgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xdump/" title="-Xdump" class="md-nav__link">
      -Xdump
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenableexcessivegc/" title="-Xenableexcessivegc" class="md-nav__link">
      -Xenableexcessivegc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenableexplicitgc/" title="-Xenableexplicitgc" class="md-nav__link">
      -Xenableexplicitgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xenablestringconstantgc/" title="-Xenablestringconstantgc" class="md-nav__link">
      -Xenablestringconstantgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xfastresolve/" title="-Xfastresolve" class="md-nav__link">
      -Xfastresolve
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xfuture/" title="-Xfuture" class="md-nav__link">
      -Xfuture
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xgc/" title="-Xgc" class="md-nav__link">
      -Xgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xgcsplitheap/" title="-Xgc:splitheap" class="md-nav__link">
      -Xgc:splitheap
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xgcpolicy/" title="-Xgcpolicy" class="md-nav__link">
      -Xgcpolicy
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xgcthreads/" title="-Xgcthreads" class="md-nav__link">
      -Xgcthreads
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xgcworkpackets/" title="-Xgcworkpackets" class="md-nav__link">
      -Xgcworkpackets
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xifa/" title="-Xifa" class="md-nav__link">
      -Xifa
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xint/" title="-Xint" class="md-nav__link">
      -Xint
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xss/" title="-Xiss" class="md-nav__link">
      -Xiss
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xjit/" title="-Xjit" class="md-nav__link">
      -Xjit
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xjni/" title="-Xjni" class="md-nav__link">
      -Xjni
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlinenumbers/" title="-Xlinenumbers" class="md-nav__link">
      -Xlinenumbers
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xloa/" title="-Xloa" class="md-nav__link">
      -Xloa
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xloaminimum/" title="-Xloainitial" class="md-nav__link">
      -Xloainitial
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xloaminimum/" title="-Xloamaximum" class="md-nav__link">
      -Xloamaximum
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xloaminimum/" title="-Xloaminimum" class="md-nav__link">
      -Xloaminimum
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlockreservation/" title="-XlockReservation" class="md-nav__link">
      -XlockReservation
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlockword/" title="-Xlockword" class="md-nav__link">
      -Xlockword
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlog/" title="-Xlog" class="md-nav__link">
      -Xlog
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlp/" title="-Xlp" class="md-nav__link">
      -Xlp
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlpcodecache/" title="-Xlp:codecache" class="md-nav__link">
      -Xlp:codecache
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlpobjectheap/" title="-Xlp:objectheap" class="md-nav__link">
      -Xlp:objectheap
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmine/" title="-Xmaxe" class="md-nav__link">
      -Xmaxe
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xminf/" title="-Xmaxf" class="md-nav__link">
      -Xmaxf
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmint/" title="-Xmaxt" class="md-nav__link">
      -Xmaxt
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmca/" title="-Xmca" class="md-nav__link">
      -Xmca
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmca/" title="-Xmco" class="md-nav__link">
      -Xmco
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmcrs/" title="-Xmcrs" class="md-nav__link">
      -Xmcrs
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmine/" title="-Xmine" class="md-nav__link">
      -Xmine
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xminf/" title="-Xminf" class="md-nav__link">
      -Xminf
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmint/" title="-Xmint" class="md-nav__link">
      -Xmint
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmn/" title="-Xmn" class="md-nav__link">
      -Xmn
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmn/" title="-Xmns" class="md-nav__link">
      -Xmns
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmn/" title="-Xmnx" class="md-nav__link">
      -Xmnx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmo/" title="-Xmo" class="md-nav__link">
      -Xmo
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmo/" title="-Xmoi" class="md-nav__link">
      -Xmoi
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmo/" title="-Xmos" class="md-nav__link">
      -Xmos
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmo/" title="-Xmox" class="md-nav__link">
      -Xmox
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmr/" title="-Xmr" class="md-nav__link">
      -Xmr
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmr/" title="-Xmrx" class="md-nav__link">
      -Xmrx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xms/" title="-Xms" class="md-nav__link">
      -Xms
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xmso/" title="-Xmso" class="md-nav__link">
      -Xmso
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xms/" title="-Xmx" class="md-nav__link">
      -Xmx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xaot/" title="-Xnoaot" class="md-nav__link">
      -Xnoaot
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xclassgc/" title="-Xnoclassgc" class="md-nav__link">
      -Xnoclassgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompactexplicitgc/" title="-Xnocompactexplicitgc" class="md-nav__link">
      -Xnocompactexplicitgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompactgc/" title="-Xnocompactgc" class="md-nav__link">
      -Xnocompactgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xcompressedrefs/" title="-Xnocompressedrefs" class="md-nav__link">
      -Xnocompressedrefs
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xjit/" title="-Xnojit" class="md-nav__link">
      -Xnojit
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xlinenumbers/" title="-Xnolinenumbers" class="md-nav__link">
      -Xnolinenumbers
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xloa/" title="-Xnoloa" class="md-nav__link">
      -Xnoloa
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsigcatch/" title="-Xnosigcatch" class="md-nav__link">
      -Xnosigcatch
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsigchain/" title="-Xnosigchain" class="md-nav__link">
      -Xnosigchain
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xnumanone/" title="-Xnuma:none" class="md-nav__link">
      -Xnuma:none
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xoptionsfile/" title="-Xoptionsfile" class="md-nav__link">
      -Xoptionsfile
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xquickstart/" title="-Xquickstart" class="md-nav__link">
      -Xquickstart
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xrs/" title="-Xrs" class="md-nav__link">
      -Xrs
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsamplingexpirationtime/" title="-XsamplingExpirationTime" class="md-nav__link">
      -XsamplingExpirationTime
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscdmx/" title="-Xscdmx" class="md-nav__link">
      -Xscdmx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscminaot/" title="-Xscmaxaot" class="md-nav__link">
      -Xscmaxaot
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscminjitdata/" title="-Xscmaxjitdata" class="md-nav__link">
      -Xscmaxjitdata
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscminaot/" title="-Xscminaot" class="md-nav__link">
      -Xscminaot
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscminjitdata/" title="-Xscminjitdata" class="md-nav__link">
      -Xscminjitdata
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xscmx/" title="-Xscmx" class="md-nav__link">
      -Xscmx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xshareclasses/" title="-Xshareclasses" class="md-nav__link">
      -Xshareclasses
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsigcatch/" title="-Xsigcatch" class="md-nav__link">
      -Xsigcatch
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsigchain/" title="-Xsigchain" class="md-nav__link">
      -Xsigchain
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsignal/" title="-Xsignal" class="md-nav__link">
      -Xsignal
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsoftmx/" title="-Xsoftmx" class="md-nav__link">
      -Xsoftmx
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xsoftrefthreshold/" title="-Xsoftrefthreshold" class="md-nav__link">
      -Xsoftrefthreshold
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xss/" title="-Xss" class="md-nav__link">
      -Xss
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xss/" title="-Xssi" class="md-nav__link">
      -Xssi
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xtgc/" title="-Xtgc" class="md-nav__link">
      -Xtgc
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xthr/" title="-Xthr" class="md-nav__link">
      -Xthr
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xtlhprefetch/" title="-XtlhPrefetch" class="md-nav__link">
      -XtlhPrefetch
    </a>
  </li>

        
  <li class="md-nav__item md-nav__item--active">
    
    <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
    
      
      <label class="md-nav__link md-nav__link--active" for="__toc">
        -Xtrace
      </label>
    
    <a href="./" title="-Xtrace" class="md-nav__link md-nav__link--active">
      -Xtrace
    </a>
    
      
<nav class="md-nav md-nav--secondary">
  
  
    <label class="md-nav__title" for="__toc">On this page ...</label>
    <ul class="md-nav__list" data-md-scrollfix>
      
        <li class="md-nav__item">
  <a href="#xtrace-option-builder" class="md-nav__link">
    Xtrace Option Builder
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#syntax" class="md-nav__link">
    Syntax
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#configuring-trace" class="md-nav__link">
    Configuring trace
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#controlling-tracepoint-activation" class="md-nav__link">
    Controlling tracepoint activation
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#about-trace" class="md-nav__link">
    About trace
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#default-tracing" class="md-nav__link">
    Default tracing
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#default-memory-management-tracing" class="md-nav__link">
    Default memory management tracing
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#default-assertion-tracing" class="md-nav__link">
    Default assertion tracing
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#tracepoint-activation" class="md-nav__link">
    Tracepoint activation
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#tracepoint-specification" class="md-nav__link">
    Tracepoint specification
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#trace-levels" class="md-nav__link">
    Trace levels
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#parameters" class="md-nav__link">
    Parameters
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#buffers" class="md-nav__link">
    buffers
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#count-tracepoint" class="md-nav__link">
    count (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#exception-tracepoint" class="md-nav__link">
    exception (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#exceptionoutput" class="md-nav__link">
    exception.output
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#external-tracepoint" class="md-nav__link">
    external (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#help" class="md-nav__link">
    help
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#iprint-tracepoint" class="md-nav__link">
    iprint (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#maximal-tracepoint" class="md-nav__link">
    maximal (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#methods" class="md-nav__link">
    methods
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#minimal-tracepoint" class="md-nav__link">
    minimal (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#none-tracepoint" class="md-nav__link">
    none (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#output" class="md-nav__link">
    output
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#print-tracepoint" class="md-nav__link">
    print (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#properties" class="md-nav__link">
    properties
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#resume" class="md-nav__link">
    resume
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#resumecount" class="md-nav__link">
    resumecount
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#sleeptime" class="md-nav__link">
    sleeptime
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#stackdepth" class="md-nav__link">
    stackdepth
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#suspend" class="md-nav__link">
    suspend
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#suspendcount" class="md-nav__link">
    suspendcount
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#trigger" class="md-nav__link">
    trigger
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#types" class="md-nav__link">
    Types
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#actions" class="md-nav__link">
    Actions
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#what" class="md-nav__link">
    what
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#see-also" class="md-nav__link">
    See also
  </a>
  
</li>
      
      
    </ul>
  
</nav>
    
  </li>

        
  <li class="md-nav__item">
    <a href="../xtunevirtualized/" title="-Xtune:virtualized" class="md-nav__link">
      -Xtune:virtualized
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xverbosegclog/" title="-Xverbosegclog" class="md-nav__link">
      -Xverbosegclog
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xverify/" title="-Xverify" class="md-nav__link">
      -Xverify
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xzero/" title="-Xzero" class="md-nav__link">
      -Xzero
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-12-6" type="checkbox" id="nav-12-6">
    
    <label class="md-nav__link" for="nav-12-6">
      JVM -XX options
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="2">
      <label class="md-nav__title" for="nav-12-6">
        JVM -XX options
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../xx_jvm_commands/" title="Using -XX options" class="md-nav__link">
      Using -XX options
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxactiveprocessorcount/" title="-XXActiveProcessorCount" class="md-nav__link">
      -XXActiveProcessorCount
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxallowvmshutdown/" title="-XXallowvmshutdown" class="md-nav__link">
      -XXallowvmshutdown
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxclassrelationshipverifier/" title="-XX:[+|-]ClassRelationshipVerifier" class="md-nav__link">
      -XX:[+|-]ClassRelationshipVerifier
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxconcgcthreads/" title="-XX:ConcGCThreads" class="md-nav__link">
      -XX:ConcGCThreads
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxcodecachetotal/" title="-XX:codecachetotal" class="md-nav__link">
      -XX:codecachetotal
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxcompactstrings/" title="-XX:[+|-]CompactStrings" class="md-nav__link">
      -XX:[+|-]CompactStrings
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxdisableexplicitgc/" title="-XX:[+|-]DisableExplicitGC" class="md-nav__link">
      -XX:[+|-]DisableExplicitGC
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxdisclaimjitscratch/" title="-XX:[+|-]DisclaimJitScratch" class="md-nav__link">
      -XX:[+|-]DisclaimJitScratch
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxenablecpumonitor/" title="-XX:[+|-]EnableCPUMonitor" class="md-nav__link">
      -XX:[+|-]EnableCPUMonitor
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxexitonoutofmemoryerror/" title="-XX:[+|-]ExitOnOutOfMemoryError" class="md-nav__link">
      -XX:[+|-]ExitOnOutOfMemoryError
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxhandlesigxfsz/" title="-XX:[+|-]handleSIGXFSZ" class="md-nav__link">
      -XX:[+|-]handleSIGXFSZ
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxheapdumponoutofmemory/" title="-XX:[+|-]HeapDumpOnOutOfMemory" class="md-nav__link">
      -XX:[+|-]HeapDumpOnOutOfMemory
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxheapdumppath/" title="-XX:HeapDumpPath" class="md-nav__link">
      -XX:HeapDumpPath
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxheapmanagementmxbeancompatibility/" title="-XX:[+|-]HeapManagementMXBeanCompatibility" class="md-nav__link">
      -XX:[+|-]HeapManagementMXBeanCompatibility
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxidletuningcompactonidle/" title="-XX:[+|-]IdleTuningCompactOnIdle" class="md-nav__link">
      -XX:[+|-]IdleTuningCompactOnIdle
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxidletuninggconidle/" title="-XX:[+|-]IdleTuningGcOnIdle" class="md-nav__link">
      -XX:[+|-]IdleTuningGcOnIdle
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxidletuningminfreeheaponidle/" title="-XX:IdleTuningMinFreeHeapOnIdle" class="md-nav__link">
      -XX:IdleTuningMinFreeHeapOnIdle
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxidletuningminidlewaittime/" title="-XX:IdleTuningMinIdleWaitTime" class="md-nav__link">
      -XX:IdleTuningMinIdleWaitTime
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxignoreunrecognizedvmoptions/" title="-XX:[+|-]IgnoreUnrecognizedVMOptions" class="md-nav__link">
      -XX:[+|-]IgnoreUnrecognizedVMOptions
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxignoreunrecognizedxxcolonoptions/" title="-XX:[+|-]IgnoreUnrecognizedXXColonOptions" class="md-nav__link">
      -XX:[+|-]IgnoreUnrecognizedXXColonOptions
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxinitialrampercentage/" title="-XX:InitialRAMPercentage" class="md-nav__link">
      -XX:InitialRAMPercentage
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxinitialheapsize/" title="-XX:InitialHeapSize" class="md-nav__link">
      -XX:InitialHeapSize
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxinterleavememory/" title="-XX:[+|-]InterleaveMemory" class="md-nav__link">
      -XX:[+|-]InterleaveMemory
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxjitinlinewatches/" title="-XX:[+|-]JITInlineWatches" class="md-nav__link">
      -XX:[+|-]JITInlineWatches
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxlazysymbolresolution/" title="-XX:[+|-]LazySymbolResolution" class="md-nav__link">
      -XX:[+|-]LazySymbolResolution
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxmaxdirectmemorysize/" title="-XX:MaxDirectMemorySize" class="md-nav__link">
      -XX:MaxDirectMemorySize
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxinitialheapsize/" title="-XX:MaxHeapSize" class="md-nav__link">
      -XX:MaxHeapSize
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxinitialrampercentage/" title="-XX:MaxRAMPercentage" class="md-nav__link">
      -XX:MaxRAMPercentage
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxonoutofmemoryerror/" title="-XX:OnOutOfMemoryError" class="md-nav__link">
      -XX:OnOutOfMemoryError
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxnosuballoc32bitmem/" title="-XXnosuballoc32bitmem" class="md-nav__link">
      -XXnosuballoc32bitmem
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxpagealigndirectmemory/" title="-XX:[+|-]PageAlignDirectMemory" class="md-nav__link">
      -XX:[+|-]PageAlignDirectMemory
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxparallelcmsthreads/" title="-XX:ParallelCMSThreads" class="md-nav__link">
      -XX:ParallelCMSThreads
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxparallelgcthreads/" title="-XX:ParallelGCThreads" class="md-nav__link">
      -XX:ParallelGCThreads
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxpositiveidentityhash/" title="-XX:[+|-]PositiveIdentityHash" class="md-nav__link">
      -XX:[+|-]PositiveIdentityHash
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxprintcodecache/" title="-XX:[+|-]PrintCodeCache" class="md-nav__link">
      -XX:[+|-]PrintCodeCache
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxreadipinfoforras/" title="-XX:[+|-]ReadIPInfoForRAS" class="md-nav__link">
      -XX:[+|-]ReadIPInfoForRAS
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxreducecpumonitoroverhead/" title="-XX:[+|-]ReduceCPUMonitorOverhead" class="md-nav__link">
      -XX:[+|-]ReduceCPUMonitorOverhead
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxruntimeinstrumentation/" title="-XX:[+|-]RuntimeInstrumentation" class="md-nav__link">
      -XX:[+|-]RuntimeInstrumentation
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxsethwprefetch/" title="-XXsetHWPrefetch" class="md-nav__link">
      -XXsetHWPrefetch
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxshareanonymousclasses/" title="-XX:[+|-]ShareAnonymousClasses" class="md-nav__link">
      -XX:[+|-]ShareAnonymousClasses
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxshareclassesenablebci/" title="-XX:ShareClassesDisableBCI" class="md-nav__link">
      -XX:ShareClassesDisableBCI
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxshareclassesenablebci/" title="-XX:ShareClassesEnableBCI" class="md-nav__link">
      -XX:ShareClassesEnableBCI
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxsharedcachehardlimit/" title="-XX:SharedCacheHardLimit" class="md-nav__link">
      -XX:SharedCacheHardLimit
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxshareunsafeclasses/" title="-XX:[+|-]ShareUnsafeClasses" class="md-nav__link">
      -XX:[+|-]ShareUnsafeClasses
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxstacktraceinthrowable/" title="-XX:-StackTraceInThrowable" class="md-nav__link">
      -XX:-StackTraceInThrowable
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxtransparenthugepage/" title="-XX:[+|-]TransparentHugePage" class="md-nav__link">
      -XX:[+|-]TransparentHugePage
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxusecompressedoops/" title="-XX:[+|-]UseCompressedOops" class="md-nav__link">
      -XX:[+|-]UseCompressedOops
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxusecontainersupport/" title="-XX:[+|-]UseContainerSupport" class="md-nav__link">
      -XX:[+|-]UseContainerSupport
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxusegcstartuphints/" title="-XX:[+|-]UseGCStartupHints" class="md-nav__link">
      -XX:[+|-]UseGCStartupHints
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxusenogc/" title="-XX:[+|-]UseNoGC" class="md-nav__link">
      -XX:[+|-]UseNoGC
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxverboseverification/" title="-XX:[+|-]VerboseVerification" class="md-nav__link">
      -XX:[+|-]VerboseVerification
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../xxvmlockclassloader/" title="-XX:[+|-]VMLockClassLoader" class="md-nav__link">
      -XX:[+|-]VMLockClassLoader
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

        
      </ul>
    </nav>
  </li>

    
  <li class="md-nav__item md-nav__item--nested">
    
      <input class="md-toggle md-nav__toggle" data-md-toggle="nav-13" type="checkbox" id="nav-13">
    
    <label class="md-nav__link" for="nav-13">
       Reference
    </label>
    <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
      <label class="md-nav__title" for="nav-13">
         Reference
      </label>
      <ul class="md-nav__list" data-md-scrollfix>
        
        
  <li class="md-nav__item">
    <a href="../openj9_support/" title="Supported environments" class="md-nav__link">
      Supported environments
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../openj9_defaults/" title="Default settings" class="md-nav__link">
      Default settings
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../openj9_signals/" title="Signal handling" class="md-nav__link">
      Signal handling
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../openj9_directories/" title="Directory conventions" class="md-nav__link">
      Directory conventions
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../messages_intro/" title="OpenJ9 messages" class="md-nav__link">
      OpenJ9 messages
    </a>
  </li>

        
  <li class="md-nav__item">
    <a href="../env_var/" title="Environment variables" class="md-nav__link">
      Environment variables
    </a>
  </li>

        
      </ul>
    </nav>
  </li>

    
  <li class="md-nav__item">
    <a href="../legal/" title="Legal" class="md-nav__link">
      Legal
    </a>
  </li>

    
  </ul>
</nav>
                  </div>
                </div>
              </div>
            
            
              <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    
<nav class="md-nav md-nav--secondary">
  
  
    <label class="md-nav__title" for="__toc">On this page ...</label>
    <ul class="md-nav__list" data-md-scrollfix>
      
        <li class="md-nav__item">
  <a href="#xtrace-option-builder" class="md-nav__link">
    Xtrace Option Builder
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#syntax" class="md-nav__link">
    Syntax
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#configuring-trace" class="md-nav__link">
    Configuring trace
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#controlling-tracepoint-activation" class="md-nav__link">
    Controlling tracepoint activation
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#about-trace" class="md-nav__link">
    About trace
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#default-tracing" class="md-nav__link">
    Default tracing
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#default-memory-management-tracing" class="md-nav__link">
    Default memory management tracing
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#default-assertion-tracing" class="md-nav__link">
    Default assertion tracing
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#tracepoint-activation" class="md-nav__link">
    Tracepoint activation
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#tracepoint-specification" class="md-nav__link">
    Tracepoint specification
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#trace-levels" class="md-nav__link">
    Trace levels
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#parameters" class="md-nav__link">
    Parameters
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#buffers" class="md-nav__link">
    buffers
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#count-tracepoint" class="md-nav__link">
    count (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#exception-tracepoint" class="md-nav__link">
    exception (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#exceptionoutput" class="md-nav__link">
    exception.output
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#external-tracepoint" class="md-nav__link">
    external (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#help" class="md-nav__link">
    help
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#iprint-tracepoint" class="md-nav__link">
    iprint (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#maximal-tracepoint" class="md-nav__link">
    maximal (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#methods" class="md-nav__link">
    methods
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#minimal-tracepoint" class="md-nav__link">
    minimal (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#none-tracepoint" class="md-nav__link">
    none (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#output" class="md-nav__link">
    output
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#print-tracepoint" class="md-nav__link">
    print (tracepoint)
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#properties" class="md-nav__link">
    properties
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#resume" class="md-nav__link">
    resume
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#resumecount" class="md-nav__link">
    resumecount
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#sleeptime" class="md-nav__link">
    sleeptime
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#stackdepth" class="md-nav__link">
    stackdepth
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#suspend" class="md-nav__link">
    suspend
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#suspendcount" class="md-nav__link">
    suspendcount
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#trigger" class="md-nav__link">
    trigger
  </a>
  
    <nav class="md-nav">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#types" class="md-nav__link">
    Types
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#actions" class="md-nav__link">
    Actions
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
        
          <li class="md-nav__item">
  <a href="#what" class="md-nav__link">
    what
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
        <li class="md-nav__item">
  <a href="#see-also" class="md-nav__link">
    See also
  </a>
  
</li>
      
      
    </ul>
  
</nav>
                  </div>
                </div>
              </div>
            
          
          <div class="md-content">
            <article class="md-content__inner md-typeset">
              
<!-- this adds 'pencil' icon to H1 so that you can edit the page directly in GitHub
                
                  <a href="https://github.com/eclipse/openj9-docs/edit/master/docs/xtrace.md" title="Edit this page" class="md-icon md-content__icon">&#xE3C9;</a>
                
-->
                
                <!--
* Copyright (c) 2017, 2020 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->

<h1 id="-xtrace">-Xtrace</h1>
<p>OpenJ9 VM tracing is a powerful feature to help you diagnose problems with minimal effect on performance. Tracing is enabled by default, together with a small set of trace points going to memory buffers. You can enable tracepoints at run time by using levels, components, group names, or individual tracepoint identifiers to trace VM internal operations and instrumented Java&trade; applications. You can also trace Java methods. See the <a href="#about-trace">About trace</a> section that follows for more detail.</p>
<p>Trace data can be output in human-readable or in compressed binary formats. The VM provides a tool to process and convert the compressed binary data into a readable format. See <a href="../tool_traceformat/">Trace formatter</a>.  </p>
<p><i class="fa fa-pencil-square-o" aria-hidden="true"></i> <strong>Note:</strong> You can also control trace by using the <code>com.ibm.jvm.Trace</code> API or by using JVMTI from an external agent.</p>
<h2 id="xtrace-option-builder">Xtrace Option Builder</h2>
<p>Use the <a href="https://www.eclipse.org/openj9/tools/xtrace_option_builder.html" target="_blank">Xtrace Option Builder tool</a> to help you specify the correct options and avoid incompatibilities.</p>
<h2 id="syntax">Syntax</h2>
<pre><code>-Xtrace:&lt;parameter&gt;
</code></pre>
<p>You can get help with <code>-Xtrace</code>by using the following options:</p>
<ul>
<li><code>-Xtrace:help</code> &nbsp; Displays general trace help</li>
<li><code>-Xtrace:what</code> &nbsp; Shows the current trace settings</li>
</ul>
<!--
The following table lists the parameters for `-Xtrace` that provide usage and configuration information:

| Command        | Result                             |
|----------------|------------------------------------|
| `-Xtrace:help` | Displays general trace help        |
| `-Xtrace:what` | Shows the current trace settings   |
 -->

<h3 id="configuring-trace">Configuring trace</h3>
<p>The following parameters can be used to configure trace. (Follow links for more information about individual options.)</p>
<table>
<thead>
<tr>
<th>Command</th>
<th>Result</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="#properties"><code>-Xtrace:properties[=&lt;filename&gt;]</code></a></td>
<td>Configures trace options based on a file</td>
</tr>
<tr>
<td><a href="#buffers"><code>-Xtrace:buffers=&lt;size&gt;[dynamic\|nodynamic]</code></a></td>
<td>Modifies the size of buffers that are used to store trace data</td>
</tr>
<tr>
<td><a href="#exceptionoutput"><code>-Xtrace:exception.output=&lt;filename&gt;[,&lt;size&gt;]</code></a></td>
<td>Redirects exceptions trace data to a file.</td>
</tr>
<tr>
<td><a href="#methods"><code>-Xtrace:methods=&lt;method_specification&gt;</code></a></td>
<td>Traces methods</td>
</tr>
<tr>
<td><a href="#output"><code>-Xtrace:output=&lt;filename&gt;[,&lt;size&gt;[,&lt;generations&gt;]]</code></a></td>
<td>Sends trace data to a file, optionally of a specific size and number of generations.</td>
</tr>
<tr>
<td><a href="#resume"><code>-Xtrace:resume</code></a></td>
<td>Resumes tracing globally.</td>
</tr>
<tr>
<td><a href="#resumecount"><code>-Xtrace:resumecount=&lt;count&gt;</code></a></td>
<td>Enables tracing at a thread level after a specified count.</td>
</tr>
<tr>
<td><a href="#sleeptime"><code>-Xtrace:sleeptime=&lt;time&gt;</code></a></td>
<td>Pauses trace operations for a specified length of time.</td>
</tr>
<tr>
<td><a href="#stackdepth"><code>-Xtrace:stackdepth=&lt;n&gt;</code></a></td>
<td>Limits the maximum number of stack frames reported by the jstacktrace trace trigger action.</td>
</tr>
<tr>
<td><a href="#suspend"><code>-Xtrace:suspend</code></a></td>
<td>Suspends tracing globally.</td>
</tr>
<tr>
<td><a href="#suspendcount"><code>-Xtrace:suspendcount=&lt;count&gt;</code></a></td>
<td>Suspends tracing at a thread level after a specified count.</td>
</tr>
<tr>
<td><a href="#trigger"><code>-Xtrace:trigger=&lt;clause&gt;</code></a></td>
<td>Determines when various triggered trace actions occur, including turning trace on or off.</td>
</tr>
</tbody>
</table>
<p><i class="fa fa-pencil-square-o" aria-hidden="true"></i> <strong>Note:</strong> If an option value contains commas, it must be enclosed in braces. For example: <code>methods={java/lang/*,com/ibm/*}</code></p>
<h3 id="controlling-tracepoint-activation">Controlling tracepoint activation</h3>
<p>The following parameters can be used to control tracepoint activation. (Follow links for more information about individual options.)</p>
<table>
<thead>
<tr>
<th>Command</th>
<th>Result</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="#maximal-tracepoint"><code>-Xtrace:maximal=&lt;tracepoint_specification&gt;</code></a></td>
<td>Records all associated data.</td>
</tr>
<tr>
<td><a href="#minimal-tracepoint"><code>-Xtrace:minimal=&lt;tracepoint_specification&gt;</code></a></td>
<td>Records only the time stamp and tracepoint identifier.</td>
</tr>
<tr>
<td><a href="#count-tracepoint"><code>-Xtrace:count=&lt;tracepoint_specification&gt;</code></a></td>
<td>Counts the tracepoints that are used in a trace configuration.</td>
</tr>
<tr>
<td><a href="#print-tracepoint"><code>-Xtrace:print=&lt;tracepoint_specification&gt;</code></a></td>
<td>Prints the specified tracepoints to stderr in real time.</td>
</tr>
<tr>
<td><a href="#iprint-tracepoint"><code>-Xtrace:iprint=&lt;tracepoint_specification&gt;</code></a></td>
<td>Prints the specified tracepoints to stderr in real time with indentation.</td>
</tr>
<tr>
<td><a href="#exception-tracepoint"><code>-Xtrace:exception=&lt;tracepoint_specification&gt;</code></a></td>
<td>Enables exception tracing.</td>
</tr>
<tr>
<td><a href="#external-tracepoint"><code>-Xtrace:external&lt;tracepoint_specification&gt;</code></a></td>
<td>Routes trace data to trace listeners, which are registered by using the JVMTI APIs.</td>
</tr>
<tr>
<td><a href="#none-tracepoint"><code>-Xtrace:none[=&lt;tracepoint_specification&gt;]</code></a></td>
<td>Prevents the trace engine from loading if it is the only trace option specified.</td>
</tr>
</tbody>
</table>
<p><i class="fa fa-pencil-square-o" aria-hidden="true"></i> <strong>Note:</strong> These options control which individual tracepoints are activated at run time and the implicit destination of the trace data. All these properties are independent of each other and can be mixed and matched in any way that you choose. For more information, see <a href="#tracepoint-activation">Tracepoint activation</a>.</p>
<h2 id="about-trace">About trace</h2>
<p>With the OpenJ9 trace feature, you can trace VM internal operations, Java applications, and Java methods, or any combination of these.</p>
<dl>
<dt>VM internal operations</dt>
<dd>The OpenJ9 virtual machine (VM) is extensively instrumented with tracepoints for tracing operations. Interpreting this trace data requires detailed knowledge of the VM, and is intended to diagnose VM problems. No guarantee is given that tracepoints will not vary from release to release and from platform to platform.</dd>
<dt>Applications</dt>
<dd>VM trace contains an application trace facility that allows tracepoints to be placed in Java code, enabling you to combine trace data with the other forms of trace. This capability is supported by the <code>com.ibm.jvm.Trace</code> API. Note that an instrumented Java application runs only on an OpenJ9 VM. For more information, see <a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/trace_application.html">Application trace</a>.</dd>
<dt>Java methods</dt>
<dd>Use method trace to debug and trace application code and the system classes provided with the VM. You can trace entry to and exit from Java methods run by the VM. You can select method trace by classname, method name, or both. You can also use wildcards to create complex method selections. For more information about command syntax, see <a href="#methods">methods</a>.</dd>
</dl>
<p>Trace can produce large amounts of data in a very short time. Before running trace, think carefully about what information you need in order to solve the problem. Here are some considerations:</p>
<ul>
<li>If you need only the trace information that is produced shortly before the problem occurs, consider wrapping the file by using the <code>output</code> option.</li>
<li>In many cases, just use internal trace with an increased buffer size and snap the trace when the problem occurs.</li>
<li>If the problem results in a thread stack dump or operating system signal or exception, trace buffers are snapped automatically to a file that is in the current directory. The file is called: <code>Snapnnnn.
yyyymmdd.hhmmssth.process.trc</code>.</li>
</ul>
<p>You must also think carefully about which components need to be traced and what level of tracing is required. For example, if you are tracing a suspected shared classes problem, it might be enough to trace all components at level 1, and <strong>j9shr</strong> at level 9, while <code>maximal</code> can be used to show parameters and other information for the failing component. Tracepoint components and trace levels are described in the following sections: <a href="#tracepoint-specification">Tracepoint specification</a> and <a href="#trace-levels">Trace levels</a>.</p>
<p>There are two types of tracepoints inside the VM:  </p>
<ul>
<li>Regular tracepoints include method tracepoints, application tracepoints, data tracepoints inside the VM and data tracepoints inside class libraries. You can display regular tracepoint data on the screen or save the data to a file. You can also use command line options to trigger specific actions when regular tracepoints fire.</li>
<li>Auxiliary tracepoints are a special type of tracepoint that can be fired only when another tracepoint is being processed. For example, the stack frame information produced by the jstacktrace <code>-Xtrace:trigger</code> command. You cannot control where auxiliary tracepoint data is sent and you cannot set triggers on auxiliary tracepoints. Auxiliary tracepoint data is sent to the same destination as the tracepoint that caused them to be generated.</li>
</ul>
<p>Trace data can be written to one of the following locations:</p>
<ul>
<li>Memory buffers that can be dumped or snapped when a problem occurs. Use the <code>-Xtrace:buffers=&lt;size&gt;</code> option to control the size of the buffer allocated to each thread. Buffers allocated to a thread are discarded when that thread terminates. To examine the trace data captured in these memory buffers, you must snap or dump the data, then format the buffers.</li>
<li>One or more files that are using buffered I/O. Use the <code>-Xtrace:output</code> option.</li>
<li>An external agent in real time, using the <code>-Xtrace:external</code> option.</li>
<li>stderr in real time.</li>
<li>Any combination of the other items in this list.</li>
</ul>
<h2 id="default-tracing">Default tracing</h2>
<p>By default, the equivalent of the following trace command line is always available in the VM:</p>
<pre><code>-Xtrace:maximal=all{level1},exception=j9mm{gclogger}
</code></pre>
<p>When startup is complete, the equivalent of the following command line is added to enable level 2 trace points:</p>
<pre><code>-Xtrace:maximal=all{level2}
</code></pre>
<p>Level 2 is used for default tracing that would produce too much data during the startup of the VM. If you set other trace options on the command line, or before the VM finishes startup (through use of JVMTI or the <code>com.ibm.jvm.Trace</code> API), the level 2 trace points are enabled just before your trace options are processed. This behavior ensures that the default level 2 trace points do not override any changes that you specify.</p>
<p>The data generated by the tracepoints is continuously captured in wrapping memory buffers for each thread.</p>
<p>You can find tracepoint information in the following diagnostics data:</p>
<ul>
<li>System memory dumps, extracted by using jdmpview.</li>
<li>Snap traces, generated when the VM encounters a problem or an output file is specified. Using dump agents describes more ways to create a snap trace.</li>
<li>For exception trace only, in Javadumps.</li>
</ul>
<h3 id="default-memory-management-tracing">Default memory management tracing</h3>
<p>The default trace options are designed to ensure that Javadumps always contain a record of the most recent memory management history, regardless of how much work the VM has performed since the garbage collection cycle was last called.</p>
<p>The <code>exception=j9mm{gclogger}</code> clause of the default trace set specifies that a history of garbage collection cycles that have occurred in the VM is continuously recorded. The <strong>gclogger</strong> group of tracepoints in the <strong>j9mm</strong> component constitutes a set of tracepoints that record a snapshot of each garbage collection cycle. These tracepoints are recorded in their own separate buffer, called the exception buffer. The effect is that the tracepoints are not overwritten by the higher frequency tracepoints of the VM.</p>
<p>The <em>GC History</em> section of the Javadump is based on the information in the exception buffer. If a garbage collection cycle has occurred in a traced VM, the Java dump probably contains a <em>GC History</em> section.</p>
<h3 id="default-assertion-tracing">Default assertion tracing</h3>
<p>The VM includes assertions, implemented as special trace points. By default, internal assertions are detected and diagnostics logs are produced to help assess the error.</p>
<p>Assertion failures often indicate a serious problem, and the VM usually stops immediately. In these circumstances, raise an issue, including the standard error output and any diagnostic files that are produced.</p>
<p>When an assertion trace point is reached, a message like the following output is produced on the standard error stream:</p>
<pre><code>16:43:48.671 0x10a4800    j9vm.209    *   ** ASSERTION FAILED ** at jniinv.c:251:
((javaVM == ((void *)0)))
</code></pre>
<p>This error stream is followed with information about the diagnostic logs produced:</p>
<pre><code>JVMDUMP007I JVM Requesting System Dump using 'core.20060426.124348.976.dmp'
JVMDUMP010I System Dump written to core.20060426.124348.976.dmp
JVMDUMP007I JVM Requesting Snap Dump using 'Snap0001.20060426.124648.976.trc'
JVMDUMP010I Snap Dump written to Snap0001.20060426.124648.976.trc
</code></pre>
<p>Assertions are special trace points. They can be enabled or disabled by using the standard trace command-line options.</p>
<p>Assertion failures might occur early during VM startup, before trace is enabled. In this case, the assert message has a different format, and is not prefixed by a timestamp or thread ID. For example:</p>
<pre><code>** ASSERTION FAILED ** j9vmutil.15 at thrinfo.c:371 Assert_VMUtil_true((
  publicFlags &amp; 0x200))
</code></pre>
<p>Assertion failures that occur early during startup cannot be disabled. These failures do not produce diagnostic dumps, and do not cause the VM to stop.</p>
<h2 id="tracepoint-activation">Tracepoint activation</h2>
<p>The options that control which individual tracepoints are activated at run time and the implicit destination of the trace data are listed under <a href="#controlling-tracepoint-activation">Syntax: Controlling tracepoint activation</a></p>
<!--
The following options control which individual tracepoints are activated at run time and the implicit destination of the trace data. (Follow links for more information about individual options.)

- [`-Xtrace:maximal=<tracepoint_specification>`](#maximal)          
- [`-Xtrace:minimal=<tracepoint_specification>`](#minimal)          
- [`-Xtrace:count=<tracepoint_specification>`](#count)              
- [`-Xtrace:print=<tracepoint_specification>`](#print)              
- [`-Xtrace:iprint=<tracepoint_specification>`](#iprint)            
- [`-Xtrace:exception=<tracepoint_specification>`](#exception)      
- [`-Xtrace:exception.output=<filename>[,<size>]`](#exceptionoutput)
- [`-Xtrace:external<tracepoint_specification>`](#external)         
- [`-Xtrace:none[=<tracepoint_specification>]`](#none)              

-->

<p>In some cases, you must use them with other options. For example, if you specify <code>maximal</code> or <code>minimal</code> tracepoints, the trace data is put into memory buffers. If you are going to send the data to a file, you must use an <code>output</code> option to specify the destination file name.</p>
<p>With the exception of <code>none</code>, all options require at least one <code>&lt;tracepoint_specification&gt;</code>, which is described in the following section. Multiple statements of each type of trace are allowed and their effect is cumulative. If you want to use multiple trace options of the same name, use a properties file. (See <a href="#properties"><code>properties</code></a>.)</p>
<h3 id="tracepoint-specification">Tracepoint specification</h3>
<p>Tracepoints are enabled by specifying <em>component</em> and <em>tracepoint</em>.</p>
<p>If no qualifier parameters are entered, all tracepoints are enabled, except for <code>&lt;exception.output&gt;</code> trace, where the default is all {exception}.</p>
<p>The <code>&lt;tracepoint_specification&gt;</code> syntax can be further broken down as follows:</p>
<pre><code>[!]&lt;component&gt;[{&lt;group&gt;}] or [!]&lt;component&gt;[{&lt;type&gt;}] or [!]&lt;tracepoint_id&gt;[,&lt;tracepoint_id&gt;]
</code></pre>
<p>Where:</p>
<ul>
<li>The <code>!</code> symbol is a logical <em>not</em>. That is, the tracepoints that are in a specification starting with ! are turned off.</li>
<li><code>&lt;component&gt;</code> is a Java component.</li>
<li><code>&lt;group&gt;</code> is a tracepoint group, which is a set of tracepoints that are defined within a component.</li>
<li><code>&lt;type&gt;</code> is the tracepoint type: <code>entry</code>, <code>exit</code>, <code>event</code>, <code>exception</code>, and <code>eem</code>.</li>
<li><code>&lt;tracepoint_id&gt;</code> is the tracepoint identifier. The tracepoint identifier constitutes the component name of the tracepoint, followed by its integer number inside that component. For example, <code>j9mm.49</code>, <code>j9shr.20-29</code>, <code>j9vm.15</code>. To understand these numbers, see Determining the tracepoint ID of a tracepoint.</li>
</ul>
<p>Some tracepoints can be both an <code>exit</code> and an <code>exception</code>; that is, the function ended with an error. If you specify either <code>exit</code> or <code>exception</code>, these tracepoints are included.</p>
<p>Lists of Java components and tracepoint groups can be found in the tables that follow.</p>
<p>The following table lists the possible Java components (<code>&lt;component&gt;</code>). To include all Java components, specify <strong>all</strong>.</p>
<table>
<thead>
<tr>
<th>Component name</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>avl</strong></td>
<td>VM AVL tree support</td>
</tr>
<tr>
<td><strong>io</strong></td>
<td>Class library java.io native code</td>
</tr>
<tr>
<td><strong>j9bcu</strong></td>
<td>VM byte code utilities</td>
</tr>
<tr>
<td><strong>j9bcverify</strong></td>
<td>VM byte code verification</td>
</tr>
<tr>
<td><strong>j9codertvm</strong></td>
<td>VM byte code run time</td>
</tr>
<tr>
<td><strong>j9dmp</strong></td>
<td>VM dump</td>
</tr>
<tr>
<td><strong>j9jcl</strong></td>
<td>VM class libraries</td>
</tr>
<tr>
<td><strong>j9jit</strong></td>
<td>VM JIT interface</td>
</tr>
<tr>
<td><strong>j9jni</strong></td>
<td>VM JNI support</td>
</tr>
<tr>
<td><strong>j9jvmti</strong></td>
<td>VM JVMTI support</td>
</tr>
<tr>
<td><strong>j9mm</strong></td>
<td>VM memory management</td>
</tr>
<tr>
<td><strong>j9prt</strong></td>
<td>VM port library</td>
</tr>
<tr>
<td><strong>j9scar</strong></td>
<td>VM class library interface</td>
</tr>
<tr>
<td><strong>j9shr</strong></td>
<td>VM shared classes</td>
</tr>
<tr>
<td><strong>j9trc</strong></td>
<td>VM trace</td>
</tr>
<tr>
<td><strong>j9util</strong></td>
<td>VM utilities</td>
</tr>
<tr>
<td><strong>j9vm</strong></td>
<td>VM general</td>
</tr>
<tr>
<td><strong>j9vmutil</strong></td>
<td>VM utilities</td>
</tr>
<tr>
<td><strong>j9vrb</strong></td>
<td>VM verbose stack walker</td>
</tr>
<tr>
<td><strong>map</strong></td>
<td>VM mapped memory support</td>
</tr>
<tr>
<td><strong>mt</strong></td>
<td>Java methods (see <strong>Note</strong>)</td>
</tr>
<tr>
<td><strong>net</strong></td>
<td>Class library TCP/IP networking native code</td>
</tr>
<tr>
<td><strong>pool</strong></td>
<td>VM storage pool support</td>
</tr>
<tr>
<td><strong>rpc</strong></td>
<td>VM RPC support</td>
</tr>
<tr>
<td><strong>simplepool</strong></td>
<td>VM storage pool support</td>
</tr>
<tr>
<td><strong>sunvmi</strong></td>
<td>VM class library interface</td>
</tr>
</tbody>
</table>
<p><i class="fa fa-pencil-square-o" aria-hidden="true"></i> <strong>Note:</strong> When specifying the <strong>mt</strong> component you must also specify the <code>methods</code> option.</p>
<p>The following table lists all the tracepoint groups (<code>&lt;group&gt;</code>). Each group is associated with one or more Java components:</p>
<table>
<thead>
<tr>
<th>Component name or names</th>
<th>Group name</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>j9mm</strong></td>
<td><code>gclogger</code></td>
<td>A set of tracepoints that record each garbage collection cycle. Equivalent to <code>-verbose:gc</code> output</td>
</tr>
<tr>
<td><strong>j9prt</strong></td>
<td><code>nlsmessage</code></td>
<td>A set of tracepoints that record each NLS message that is issued by the VM.</td>
</tr>
<tr>
<td><strong>j9jcl</strong>, <strong>j9vm</strong></td>
<td><code>verboseclass</code></td>
<td>A set of tracepoints that record each class as it is loaded. Equivalent to <code>-verbose:class</code> output.</td>
</tr>
<tr>
<td><strong>j9jni</strong>, <strong>j9vm</strong></td>
<td><code>checkjni</code></td>
<td>A set of tracepoints that record JNI function checks. Equivalent to <code>-Xcheck:jni</code> output.</td>
</tr>
<tr>
<td><strong>j9vm</strong></td>
<td><code>checkmemory</code></td>
<td>A set of tracepoints that record memory checks. Equivalent to <code>-Xcheck:memory</code> output.</td>
</tr>
<tr>
<td><strong>j9vm</strong></td>
<td><code>checkvm</code></td>
<td>A set of tracepoints that record VM checks. Equivalent to <code>-Xcheck:vm</code> output.</td>
</tr>
<tr>
<td><strong>j9jit</strong></td>
<td><code>verbose</code></td>
<td>A set of tracepoints that record JIT compiler configuration and method compilation. Equivalent to <code>-Xjit:verbose</code> output.</td>
</tr>
<tr>
<td><strong>mt</strong></td>
<td><code>compiledMethods</code></td>
<td>A set of tracepoints that record compiled Java methods.</td>
</tr>
<tr>
<td><strong>mt</strong></td>
<td><code>nativeMethods</code></td>
<td>A set of tracepoints that record Java native methods.</td>
</tr>
<tr>
<td><strong>mt</strong></td>
<td><code>staticMethods</code></td>
<td>A set of tracepoints that record Java static methods.</td>
</tr>
</tbody>
</table>
<p>Here are some examples:</p>
<p>To trace all tracepoints, specify the following command:</p>
<pre><code>-Xtrace:maximal=all
</code></pre>
<pre><code>To trace all tracepoints except **j9vrb** and **j9trc**, specify the following command:

    -Xtrace:minimal={all},minimal={!j9vrb,j9trc}
</code></pre>

<p>To trace all entry and exit tracepoints in <strong>j9bcu</strong>, specify the following command:</p>
<pre><code>-Xtrace:maximal={j9bcu{entry},j9bcu{exit}}
</code></pre>
<pre><code>To trace all tracepoints in **j9mm** except tracepoints 20-30, specify the following command:

    -Xtrace:maximal=j9mm,maximal=!j9mm.20-30
</code></pre>

<p>To trace tracepoints <code>j9prt.5</code> through <code>j9prt.15</code>, specify the following command:</p>
<pre><code>-Xtrace:print=j9prt.5-15
</code></pre>
<pre><code>To trace all **j9trc** tracepoints, specify the following command:

    -Xtrace:count=j9trc
</code></pre>

<p>To trace all <code>entry</code> and <code>exit</code> tracepoints, specify the following command:</p>
<pre><code>-Xtrace:external={all{entry},all{exit}}
</code></pre>
<h3 id="trace-levels">Trace levels</h3>
<p>Tracepoints have been assigned levels 0 through 9 that are based on the importance of the tracepoint.</p>
<p>A level 0 tracepoint is the most important. It is reserved for extraordinary events and errors. A level 9 tracepoint is in-depth component detail. To specify a given level of tracing, the <code>level0</code> through <code>level9</code> keywords are used. You can abbreviate these keywords to l0 through l9. For example, if <code>level5</code> is selected, all tracepoints that have levels 0 through 5 are included. Level specifications do not apply to explicit tracepoint specifications that use the <strong>TPNID</strong> keyword.</p>
<p>The level is provided as a modifier to a component specification, for example:</p>
<pre><code>-Xtrace:maximal={all{level5}}
</code></pre>
<p>or</p>
<pre><code>-Xtrace:maximal={j9mm{L2},j9trc,j9bcu{level9},all{level1}}
</code></pre>
<p>In the first example, tracepoints that have a level of 5 or less are enabled for all components. In the second example, all level 1 tracepoints are enabled. All level 2 tracepoints in <strong>j9mm</strong> are enabled. All tracepoints up to level 9 are enabled in <strong>j9bcu</strong>.</p>
<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> The level applies only to the current component. If multiple trace selection components are found in a trace properties file, the level is reset to the default for each new component.
Level specifications do not apply to explicit tracepoint specifications that use the <strong>TPNID</strong> keyword.</p>
<p>When the not operator is specified, the level is inverted; that is, <code>!j9mm{level5}</code> disables all tracepoints of level 6 or greater for the <strong>j9mm</strong> component. The following example enables trace for all components at level 9 (the default), but disables level 6 and higher for the <strong>locking</strong> component, and level 7 and higher for the <strong>storage</strong> component:</p>
<pre><code>-Xtrace:print={all},print={!j9trc{l5},j9mm{l6}}
</code></pre>
<p>Here are some examples:</p>
<p>To count the level zero and level one tracepoints matched, specify the following command:</p>
<pre><code>-Xtrace:count=all{L1}
</code></pre>
<p>To produce maximal trace of all components at level 5 and <strong>j9mm</strong> at level 9, specify the following command:</p>
<pre><code>-Xtrace:maximal={all{level5},j9mm{L9}}
</code></pre>
<p>To trace all components at level 6, but do not trace <code>j9vrb</code> at all, and do not trace the <code>entry</code> and <code>exit</code> tracepoints in the <strong>j9trc</strong> component, specify the following command:</p>
<pre><code>-Xtrace:minimal={all{l6}},minimal={!j9vrb,j9trc{entry},j9trc{exit}}
</code></pre>
<h2 id="parameters">Parameters</h2>
<p>Parameters to use with the <code>-Xtrace</code> option:</p>
<h3 id="buffers"><code>buffers</code></h3>
<p>You can modify the size of the buffers to change how much diagnostic output is provided in a snap dump. This buffer is allocated for each thread that makes trace entries. The following table shows
how this parameter can be set:</p>
<table>
<thead>
<tr>
<th>Command</th>
<th>Effect</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>-Xtrace:buffers=&lt;size&gt;</code></td>
<td>Creates buffers of the specified <code>&lt;size&gt;</code> in <em>k</em> (KB) or <em>m</em> (MB), allocated as needed to match the rate of trace data generation to the output media.</td>
</tr>
<tr>
<td><code>-Xtrace:buffers=&lt;size&gt;dynamic</code></td>
<td>Creates buffers of the specified <code>&lt;size&gt;</code>, allocated as needed to match the rate of trace data generation to the output media.</td>
</tr>
<tr>
<td><code>-Xtrace:buffers=&lt;size&gt;nodynamic</code></td>
<td>Creates buffers of the specified <code>&lt;size&gt;</code>, with a maximum allocation of two buffers per thread.</td>
</tr>
</tbody>
</table>
<p>If external trace is enabled, the number of buffers is doubled; that is, each thread allocates two or more buffers. The same buffer size is used for state and exception tracing, but, in this case, buffers are allocated globally. The default is 8 KB per thread.</p>
<p>The <code>dynamic</code> and <code>nodynamic</code> suboptions have meaning only when tracing to an output file.</p>
<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> If <code>nodynamic</code> is specified, you might lose trace data if the volume of trace data exceeds the bandwidth of the trace output file. Message <strong>UTE115</strong> is issued when the first trace entry is lost, and message <strong>UTE018</strong> is issued when the VM ends.</p>
<p>Here are some command line examples:</p>
<p>To set a buffer size of 2 MB per thread, with dynamic buffering, use:</p>
<pre><code>-Xtrace:buffers=2m
</code></pre>
<p>To limit each thread to 2 trace buffers, each of 128 KB:</p>
<pre><code>-Xtrace:buffers={128k,nodynamic}
</code></pre>
<h3 id="count-tracepoint"><code>count</code> (tracepoint)</h3>
<pre><code>-Xtrace:count=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>The count option requests that only a count of the selected tracepoints is kept. When the VM ends, all nonzero totals of tracepoints (sorted by tracepoint id) are written to a file, called <code>utTrcCounters</code>, in the current directory. This information is useful if you want to determine the overhead of particular tracepoints, but do not want to produce a large amount (GB) of trace data.</p>
<p>For example, to count the tracepoints that are used in the default trace configuration, use the following command:</p>
<pre><code>-Xtrace:count=all{level1},count=j9mm{gclogger}
</code></pre>
<h3 id="exception-tracepoint"><code>exception</code> (tracepoint)</h3>
<pre><code>-Xtrace:exception=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>When exception trace is enabled, the trace data is collected in internal buffers that are separate from the normal buffers. These internal buffers can then be written to a snap file or written to the file that is specified in an <a href="#exceptionoutput"><code>exception.output</code></a> option.</p>
<p>The <code>exception</code> option allows low-volume tracing in buffers and files that are distinct from the higher-volume information that <code>minimal</code> and <code>maximal</code> tracing have provided. In most cases, this information is exception-type data, but you can use this option to capture any trace data that you want.</p>
<p>This form of tracing is channeled through a single set of buffers, as opposed to the buffer-per-thread approach for normal trace. Buffer contention might occur if high volumes of trace data are collected. A difference exists in the <code>&lt;tracepoint_specification&gt;</code> defaults for exception tracing;  see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p><i class="fa fa-pencil-square-o" aria-hidden="true"></i> <strong>Notes:</strong></p>
<ul>
<li>The exception trace buffers are intended for low-volume tracing. By default, the exception trace buffers log garbage collection (GC) event tracepoints, see Default tracing. You can send additional tracepoints to the exception buffers or turn off the GC tracepoints. Changing the exception trace buffers alters the contents of the GC History section in any Javadumps.</li>
<li>When exception trace is entered for an active tracepoint, the current thread ID is checked against the previous caller's thread ID. If it is a different thread, or this is the first call to exception trace, a context tracepoint is put into the trace buffer first. This context tracepoint consists only of the current thread ID, which is necessary because of the single set of buffers for exception trace. (The formatter identifies all trace entries as coming from the Exception trace pseudo thread when it formats exception trace files.)</li>
</ul>
<h3 id="exceptionoutput"><code>exception.output</code></h3>
<p>Use exception output to redirect exceptions trace data to a file.</p>
<pre><code>-Xtrace:exception.output=&lt;filename&gt;[,&lt;size&gt;]
</code></pre>
<p>Where:</p>
<ul>
<li><code>&lt;filename&gt;</code> is a file name, which is created automatically if it does not exist. Otherwise, it is overwritten. To embed specific values in the file name use any of the following variables: <em>%d%</em> (today's date in "
yyyymmdd" format), <em>%p</em> (process ID number of the process generating the trace), or <em>%t%</em> (time in 24-hour hhmmss format).</li>
<li>Optionally, <code>&lt;size&gt;</code> is a value in megabytes (MB), for example, use <em>4m</em> to specify 4 MB. When full, it wraps nondestructively to the beginning. If you do not limit the file, it grows indefinitely, until limited by disk space.</li>
</ul>
<p>Here are some examples:</p>
<p>Exception trace output goes to file <code>/u/traces/exception.trc</code> with no size limit:</p>
<pre><code>-Xtrace:exception.output=/u/traces/exception.trc,maximal
</code></pre>
<p>Exception trace output goes to file <code>except</code> and wraps at 2 MB:</p>
<pre><code>-Xtrace:exception.output={except,2m},maximal
</code></pre>
<p>Exception trace output goes to a file whose filename contains today's date in *
yyyymmdd* format (for example, <code>traceout.20181025.trc</code>):</p>
<pre><code>-Xtrace:exception.output=traceout.%d.trc,maximal
</code></pre>
<p>Exception trace output goes to a file whose filename contains the number of the process (the PID number) that generated it (for example, <code>tracefrompid2112.trc</code>):</p>
<pre><code>-Xtrace:exception.output=tracefrompid%p.trc,maximal
</code></pre>
<p>Exception trace output goes to a file whose filename contains the time in <em>hhmmss</em> format (for example, <code>traceout.080312.trc</code>):</p>
<pre><code>-Xtrace:exception.output=traceout.%t.trc,maximal
</code></pre>
<h3 id="external-tracepoint"><code>external</code> (tracepoint)</h3>
<pre><code>-Xtrace:external&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>The <code>external</code> option routes trace data to trace listeners, which are registered by using the JVMTI <code>RegisterTracePointSubscriber()</code> and <code>DeregisterTracePointSubscriber()</code> APIs.</p>
<h3 id="help"><code>help</code></h3>
<pre><code>-Xtrace:help
</code></pre>
<p>Displays general trace help</p>
<h3 id="iprint-tracepoint"><code>iprint</code> (tracepoint)</h3>
<pre><code>-Xtrace:iprint=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>The <code>iprint</code> option is the same as the <code>print</code> option, but uses indenting to format the trace.</p>
<h3 id="maximal-tracepoint"><code>maximal</code> (tracepoint)</h3>
<pre><code>-Xtrace:maximal=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>When specified, trace data is placed into internal trace buffers that can then be written to a snap file or written to the files that are specified in an output trace option. All associated data is traced.</p>
<p><code>minimal</code> and <code>maximal</code> traces are independent from any types that follow them. For example, if the <code>maximal</code> option is specified, it does not affect a later option such as <code>print</code>.</p>
<h3 id="methods"><code>methods</code></h3>
<p>Using method trace provides a complete and potentially large diagnosis of code paths inside your application and the system classes. Use wild cards and filtering to control method trace so that you can focus on the sections of code that interest you. To specify one or more method specifications, use the following syntax:</p>
<pre><code>-Xtrace:methods=&lt;method_specification&gt;[,&lt;method_specification&gt;]
</code></pre>
<p>The syntax for <code>&lt;method_specification&gt;</code> can be further broken down to the following suboptions:</p>
<pre><code>-Xtrace:methods={[!][*][&lt;package&gt;/]&lt;class&gt;[*],[[*]&lt;method&gt;[*]|[()]]}
</code></pre>
<p>Where:</p>
<ul>
<li>The delimiter between parts of the package name is a forward slash, "/".</li>
<li>The <strong>!</strong> in the methods parameter is a NOT operator that allows you to tell the VM not to trace the specified method or methods.</li>
<li>The parentheses, (), define whether or not to include method parameters in the trace.</li>
<li>If a method specification includes any commas, the whole specification must be enclosed in braces, for example: <code>-Xtrace:methods={java/lang/*,java/util/*},print=mt</code></li>
<li>It might be necessary to enclose your command line in quotation marks to prevent the shell intercepting and fragmenting comma-separated command lines, for example: <code>"-Xtrace:methods={java/lang/*,java/util/*},print=mt"</code></li>
</ul>
<p>To output all method trace information to stderr, use either the <code>print</code> or <code>iprint</code> suboptions:</p>
<pre><code>-Xtrace:print=mt,methods=*.*
-Xtrace:iprint=mt,methods=*.*
</code></pre>
<p>The <code>iprint</code> suboption prints to stderr with indentation.
To output method trace information in binary format, see the <a href="#output"><code>output</code></a> option.</p>
<p>Here are some examples:</p>
<p><em>Tracing entry and exit of all methods in a given class:</em> To trace all method entry and exit of the <code>ReaderMain</code> class in the default package and the <code>java.lang.String</code> class, specify the following command:</p>
<pre><code>-Xtrace:methods={ReaderMain.*,java/lang/String.*},print=mt
</code></pre>
<p><em>Tracing entry, exit and input parameters of all methods in a class:</em> To trace all method entry, exit, and input of the <code>ReaderMain</code> class in the default package, specify the following command:</p>
<pre><code>-Xtrace:methods=ReaderMain.*(),print=mt
</code></pre>
<p><em>Tracing all methods in a given package:</em> To trace all method entry, exit, and input of all classes in the package <code>com.ibm.socket</code>, specify the following command:</p>
<pre><code>-Xtrace:methods=com/ibm/socket/*.*(),print=mt
</code></pre>
<p><em>Multiple method trace:</em> To trace all method entry, exit, and input in the <code>Widget</code> class in the default package and all method entry and exit in the <code>common</code> package, specify the following command:</p>
<pre><code>-Xtrace:methods={Widget.*(),common/*},print=mt
</code></pre>
<p><em>Using the ! operator:</em> To trace all methods in the <code>ArticleUI</code> class in the default package except those beginning with "get", specify the following command:</p>
<pre><code>-Xtrace:methods={ArticleUI.*,!ArticleUI.get*},print=mt
</code></pre>
<p><em>Tracing a specific method in a class:</em> This example traces entry and exit of the substring method of the <code>java.lang.String class</code>. If there is more than one method with the same name, they are all traced. You cannot filter method trace by the signature of the method.</p>
<pre><code>-Xtrace:print=mt,methods={java/lang/String.substring}
</code></pre>
<p><em>Tracing the constructor of a class:</em> This example traces entry and exit of the constructors of the <code>java.lang.String</code> class.</p>
<pre><code>-Xtrace:print=mt,methods={java/lang/String.&lt;init&gt;}
</code></pre>
<p>Here is some example output:</p>
<pre><code>java "-Xtrace:methods={java/lang*.*},iprint=mt" HW
10:02:42.281*0x9e900      mt.4         &gt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4          &gt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4           &gt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4            &gt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.281 0x9e900      mt.10           &lt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.281 0x9e900      mt.10          &lt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4           &gt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.281 0x9e900      mt.10          &lt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.281 0x9e900      mt.10         &lt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4          &gt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.281 0x9e900      mt.4           &gt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.296 0x9e900      mt.10          &lt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.296 0x9e900      mt.10         &lt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.296 0x9e900      mt.4          &gt; java/lang/String.&lt;clinit&gt;()V Compiled static method
10:02:42.296 0x9e900      mt.4           &gt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.296 0x9e900      mt.4            &gt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.296 0x9e900      mt.4             &gt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.296 0x9e900      mt.10            &lt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.296 0x9e900      mt.4             &gt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.328 0x9e900      mt.10            &lt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.328 0x9e900      mt.10           &lt; java/lang/J9VMInternals.verify(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.328 0x9e900      mt.4            &gt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.328 0x9e900      mt.10           &lt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
10:02:42.328 0x9e900      mt.4            &gt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.328 0x9e900      mt.10           &lt; java/lang/J9VMInternals.setInitStatus(Ljava/lang/Class;I)
                              V Compiled static method
10:02:42.328 0x9e900      mt.10          &lt; java/lang/J9VMInternals.initialize(Ljava/lang/Class;)
                              V Compiled static method
</code></pre>
<p>The output lines comprise of:</p>
<ul>
<li><code>0x9e900</code>, the current <code>execenv</code> (execution environment). Because every VM thread has its own <code>execenv</code>, you can regard <code>execenv</code> as a <code>thread-id</code>. All trace with the same <code>execenv</code> relates to a single thread.</li>
<li>The individual tracepoint ID in the <strong>mt</strong> component that collects and emits the data.</li>
<li>The remaining fields show whether a method is being entered (&gt;) or exited (&lt;), followed by details of the method.</li>
</ul>
<h3 id="minimal-tracepoint"><code>minimal</code> (tracepoint)</h3>
<pre><code>-Xtrace:minimal=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>When specified, trace data is placed into internal trace buffers that can then be written to a snap file or written to the files that are specified in an output trace option. Only the time stamp and tracepoint identifier are recorded. When the trace is formatted, missing trace data is replaced with the characters "???" in the output file.</p>
<p><code>minimal</code> and <code>maximal</code> traces are independent from any types that follow them. For example, if the <code>minimal</code> option is specified, it does not affect a later option such as <code>print</code>.</p>
<h3 id="none-tracepoint"><code>none</code> (tracepoint)</h3>
<pre><code>-Xtrace:none[=&lt;tracepoint_specification&gt;]
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p><code>-Xtrace:none</code> prevents the trace engine from loading if it is the only trace option specified. However, if other <code>-Xtrace</code> options are on the command line, it is treated as the equivalent of <code>-Xtrace:none=all</code> and the trace engine still loads.</p>
<p>If you specify other tracepoints without specifying <code>-Xtrace:none</code>, the tracepoints are added to the default set.</p>
<h3 id="output"><code>output</code></h3>
<p>Sends trace data to a file, optionally of a specific size and number of generations.</p>
<pre><code>-Xtrace:output=&lt;filename&gt;[,&lt;size&gt;[,&lt;generations&gt;]]`
</code></pre>
<p>Where:</p>
<ul>
<li><code>&lt;filename&gt;</code> is a file name, which is created automatically if it does not exist. Otherwise, it is overwritten. To embed specific values in the file name use any of the following variables: <em>%d%</em> (today's date in "
yyyymmdd" format), <em>%p%</em> (process ID number of the process generating the trace), or <em>%t%</em> (time in 24-hour hhmmss format).</li>
<li>Optionally, <code>&lt;size&gt;</code> is a value in megabytes (MB), for example, use <em>4m</em> to specify 4 MB. When full, it wraps to the beginning. If you do not limit the file, it grows indefinitely, until limited by disk space.</li>
<li>Optionally, <code>&lt;generations&gt;</code> is a value 2 through 36. These values cause up to 36 files to be used sequentially as each file reaches its <code>&lt;size&gt;</code> threshold. When a file needs to be reused, it is overwritten. If <code>&lt;generations&gt;</code> is specified, the filename must contain a <strong>#</strong> (hash, pound symbol), which will be substituted with its generation identifier, the sequence of which is 0 through 9 followed by A through Z.</li>
</ul>
<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> When tracing to a file, buffers for each thread are written when the buffer is full or when the VM ends. If a thread has been inactive for a period of time before the VM ends, what seems to be 'old' trace data is written to the file. When formatted, it then seems that trace data is missing from the other threads, but this is an unavoidable side-effect of the buffer-per-thread design. This effect becomes especially noticeable when you use the generation facility, and format individual earlier generations.</p>
<p>Here are some examples:</p>
<p>Trace output goes to file <code>/u/traces/gc.problem</code> with no size limit:</p>
<pre><code>-Xtrace:output=/u/traces/gc.problem,maximal=j9gc
</code></pre>
<p>Trace output goes to file <code>trace</code>, which will wrap at 2 MB:</p>
<pre><code>-Xtrace:output={trace,2m},maximal=j9gc
</code></pre>
<p>Trace output goes to files <code>gc0.trc</code>, <code>gc1.trc</code>, and <code>gc2.trc</code>, each 10 MB in size:</p>
<pre><code>-Xtrace:output={gc#.trc,10m,3},maximal=j9gc
</code></pre>
<p>Trace output goes to a file, where the filename contains today's date in *
yyyymmdd* format (for example, <code>traceout.20181025.trc</code>):</p>
<pre><code>-Xtrace:output=traceout.%d.trc,maximal=j9gc
</code></pre>
<p>Trace output goes to a file whose name contains the number of the process (the PID number) that generated it (for example, <code>tracefrompid2112.trc</code>):</p>
<pre><code>-Xtrace:output=tracefrompid%p.trc,maximal=j9gc
</code></pre>
<p>Trace output goes to a file whose name contains the time in <em>hhmmss</em> format (for example, <code>traceout.080312.trc</code>):</p>
<pre><code>-Xtrace:output=traceout.%t.trc,maximal=j9gc
</code></pre>
<h3 id="print-tracepoint"><code>print</code> (tracepoint)</h3>
<pre><code>-Xtrace:print=&lt;tracepoint_specification&gt;
</code></pre>
<p>For further information about <code>&lt;tracepoint_specification&gt;</code> syntax, see <a href="#tracepoint-specification">Tracepoint specification</a>.</p>
<p>The print option causes the specified tracepoints to be routed to stderr in real time. The VM tracepoints are formatted by using <code>J9TraceFormat.dat</code>. The class library tracepoints are formatted by <code>J9TraceFormat.dat</code> and <code>TraceFormat.dat</code>.</p>
<h3 id="properties"><code>properties</code></h3>
<p>You can use properties files to control trace. A properties file saves typing and allows you to create a library of files that are tailored to solving problems in a particular area.</p>
<pre><code>-Xtrace:properties[=&lt;filename&gt;]
</code></pre>
<p>If <code>&lt;filename&gt;</code> is not specified, the VM searches for a default name of <strong>IBMTRACE.properties</strong> in the current directory.</p>
<p>All the options that are in the file are processed in the sequence in which they are stored in the file, before the next option that is obtained through the normal mechanism is processed. Therefore, a command-line property always overrides a property that is in the file.</p>
<p>Here is an example of a properties file:</p>
<pre><code>minimal=all
// maximal=j9mm
maximal=j9shr
buffers=128k,nodynamic
output=c:\traces\classloader.trc
print=tpnid(j9vm.23-25)
</code></pre>
<p>The following restrictions apply to the file:</p>
<ul>
<li>The file must be a flat ASCII file.</li>
<li>Nesting is not supported; that is, the file cannot contain a properties option.</li>
<li>You cannot leave properties that have the form <code>&lt;name&gt;=&lt;value&gt;</code> to default if they are specified in the property file; that is, you must specify a value, for example <code>maximal=all</code>.</li>
<li>Do not add white space before, after, or within the trace options.</li>
</ul>
<p>If any error is found when the file is accessed, VM initialization fails with an explanatory error message and return code.</p>
<p>To use a file <code>trace.props</code> stored in the <code>c:\trc\gc</code> directory, specify the following command:</p>
<pre><code>-Xtrace:properties=c:\trc\gc\trace.props
</code></pre>
<h3 id="resume"><code>resume</code></h3>
<p>The resume option resumes tracing globally.</p>
<pre><code>-Xtrace:resume
</code></pre>
<p>The <code>suspend</code> and <code>resume</code> options are not recursive. That is, two suspends that are followed by a single resume cause trace to be resumed.</p>
<h3 id="resumecount"><code>resumecount</code></h3>
<p>This trace option determines whether tracing is enabled for each thread.</p>
<pre><code>-Xtrace:resumecount=&lt;count&gt;
</code></pre>
<p>If <code>&lt;count&gt;</code> is greater than zero, each thread initially has its tracing disabled and must receive <code>&lt;count&gt;</code> <code>resumethis</code> actions before it starts tracing. This option is used with the <a href="#trigger">trigger</a> option.</p>
<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> You cannot use <code>resumecount</code> and <code>suspendcount</code> together because they use the same internal counter.</p>
<p>The following example starts with all tracing turned off. Each thread starts tracing when it has had three <code>resumethis</code> actions performed on it:</p>
<pre><code>-Xtrace:resumecount=3
</code></pre>
<h3 id="sleeptime"><code>sleeptime</code></h3>
<p>You can specify how long the sleep lasts when using the <code>sleep</code> trigger action.</p>
<pre><code>-Xtrace:sleeptime=nnn|aaams|bbbs
</code></pre>
<p>Where:</p>
<ul>
<li><em>nnn</em> sleeps for <em>nnn</em> milliseconds.</li>
<li><em>aaams</em> sleeps for <em>aaa</em> milliseconds.</li>
<li><em>bbbs</em> sleeps for <em>bbb</em> seconds.</li>
</ul>
<p>The default length of time is 30 seconds. If no units are specified, the default time unit is milliseconds.</p>
<h3 id="stackdepth"><code>stackdepth</code></h3>
<p>Use this option to limit the maximum number of stack frames reported by the <code>jstacktrace</code> trace trigger action.</p>
<pre><code>-Xtrace:stackdepth=&lt;n&gt;
</code></pre>
<p>Where <code>&lt;n&gt;</code> is the maximum number of stack frames reported.</p>
<h3 id="suspend"><code>suspend</code></h3>
<pre><code>-Xtrace:suspend
</code></pre>
<p>Suspends tracing globally for all threads and all forms of tracing but leaves tracepoints activated.</p>
<h3 id="suspendcount"><code>suspendcount</code></h3>
<p>This trace option determines whether tracing is enabled for each thread.</p>
<pre><code>-Xtrace:suspendcount=&lt;count&gt;
</code></pre>
<p>If <code>&lt;count&gt;</code> is greater than zero, each thread initially has its tracing enabled and must receive <code>&lt;count&gt;</code> <code>suspendthis</code> actions before it stops tracing.</p>
<p><i class="fa fa-pencil-square-o"></i> You cannot use <code>resumecount</code> and <code>suspendcount</code> together because they both set the same internal counter.</p>
<p>This trace option is for use with the <a href="#trigger">trigger</a> option.</p>
<p>The following example starts with tracing turned on. Each thread stops tracing when it has had three <code>suspendthis</code> actions performed on it:</p>
<pre><code>-Xtrace:suspendcount=3
</code></pre>
<h3 id="trigger"><code>trigger</code></h3>
<p>The <code>trigger</code> parameter determines when various triggered trace actions occur. Supported actions include turning tracing on and off for all threads, turning tracing on or off for the current thread, or producing various dumps.</p>
<pre><code>-Xtrace:trigger=&lt;clause&gt;[,&lt;clause&gt;]
</code></pre>
<p>This trace option does not control <em>what</em> is traced. It controls only whether the information that has been selected by the other trace options is produced as normal or is blocked.</p>
<h4 id="types">Types</h4>
<p>Each clause of the <code>trigger</code> parameter can be one of the following types:</p>
<ul>
<li>a method (<code>-Xtrace:trigger=method{...}</code>)</li>
<li>a tracepoint ID (<code>-Xtrace:trigger=tpnid{...}</code>)</li>
<li>a group (<code>-Xtrace:trigger=group{...}</code>)</li>
</ul>
<p>You can specify multiple clauses of the same type if required, but you do not need to specify all types.</p>
<dl>
<dt><em>method</em></dt>
<dd>
<pre><code> -Xtrace:trigger=method{&lt;methodspec&gt;[,&lt;entryAction&gt;[,&lt;exitAction&gt;[,&lt;delayCount&gt;[,&lt;matchcount&gt;]]]]}
</code></pre>
<p>On entering a method that matches <code>&lt;methodspec&gt;</code>, the specified <code>&lt;entryAction&gt;</code> is run. On leaving a method that matches <code>&lt;methodspec&gt;</code>, the specified <code>&lt;exitAction&gt;</code> is run. If you specify a <code>&lt;delayCount&gt;</code>, the actions are performed only after a matching <code>&lt;methodspec&gt;</code> has been entered that many times. If you specify a <code>&lt;matchCount&gt;</code>, <code>&lt;entryAction&gt;</code> and <code>&lt;exitAction&gt;</code> are performed at most that many times.</p>
<p><code>&lt;methodspec&gt;</code> is the specification of a Java method, consisting of a class and a method name separated by a dot. For example, specify <code>HelloWorld.main</code>. If the class is in a package, the package name must be included, separated by slashes. For example, specify <code>java/lang/String.getBytes</code>.</p>
<p>A wildcard "*" can be used at the start or end of the class and method names, or both. For example, you can specify <code>*/String.get*</code>. To specify a constructor method, use <code>&lt;init&gt;</code> as the method name. Method signatures cannot be specified, so a method specification applies to all overloaded methods.</p>
</dd>
<dt><em>tracepoint ID</em></dt>
<dd>
<pre><code> -Xtrace:trigger=tpnid{&lt;tpnid&gt;|&lt;tpnidRange&gt;,&lt;action&gt;[,&lt;delayCount&gt;[,&lt;matchcount&gt;]]}
</code></pre>
<p>On finding the specified active tracepoint ID (<code>&lt;tpnid&gt;</code>) or a tracepoint ID) that falls inside the specified <code>&lt;tpnidRange&gt;</code>, the specified action is <strong>run</strong>. If you specify a <code>&lt;delayCount&gt;</code>, the action is performed only after the VM finds such an active <code>&lt;tpnid&gt;</code> that many times. If you specify a <code>&lt;matchCount&gt;</code>, <code>&lt;action&gt;</code> is performed at most that many times.</p>
</dd>
<dt><em>group</em></dt>
<dd>
<pre><code> -Xtrace:trigger=group{&lt;groupname&gt;,&lt;action&gt;[,&lt;delayCount&gt;[,&lt;matchcount&gt;]]}
</code></pre>
<p>On finding any active tracepoint that is defined as being in trace group <code>&lt;groupname&gt;</code>, for example <strong>Entry</strong> or <strong>Exit</strong>, the specified action is <strong>run</strong>. If you specify a <code>&lt;delayCount&gt;</code>, the action is performed only after that many active tracepoints from group <code>&lt;groupname&gt;</code> have been found. If you specify a <code>&lt;matchCount&gt;</code>, <code>&lt;action&gt;</code> is performed at most that many times.</p>
</dd>
</dl>
<h4 id="actions">Actions</h4>
<p>Wherever an action (<code>&lt;action&gt;</code>, <code>&lt;entryAction&gt;</code>, or <code>&lt;exitAction&gt;</code>) must be specified in one of the <code>trigger</code> parameter clauses, you must select from these options:</p>
<table>
<thead>
<tr>
<th><strong><code>&lt;action&gt;</code></strong></th>
<th>Effect</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>abort</code></td>
<td>Halt the VM.</td>
</tr>
<tr>
<td><code>ceedump</code></td>
<td>This action is applicable to z/OS&reg; only. For more information, see z/OS LE CEEDUMPs.</td>
</tr>
<tr>
<td><code>coredump</code></td>
<td>See <code>sysdump</code>.</td>
</tr>
<tr>
<td><code>heapdump</code></td>
<td>Produce a Heapdump. See <a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/heapdump.html">Using Heapdump</a>.</td>
</tr>
<tr>
<td><code>javadump</code></td>
<td>Produce a Javadump. See <a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/javadump.html">Using Javadump</a>.</td>
</tr>
<tr>
<td><code>jstacktrace</code></td>
<td>Examine the Java stack of the current thread and generate auxiliary tracepoints for each stack frame. The auxiliary tracepoints are written to the same destination as the tracepoint or method trace that triggered the action. You can control the number of stack frames examined with the stackdepth=n option. See the <a href="#stackdepth">stackdepth</a> option.</td>
</tr>
<tr>
<td><code>resume</code></td>
<td>Resume all tracing (except for threads that are suspended by the action of the resumecount property and <code>Trace.suspendThis()</code> calls).</td>
</tr>
<tr>
<td><code>resumethis</code></td>
<td>Decrement the suspend count for this thread. If the suspend count is zero or less, resume tracing for this thread.</td>
</tr>
<tr>
<td><code>sigsev</code></td>
<td>Cause a segmentation violation. (Intended for use in debugging.)</td>
</tr>
<tr>
<td><code>sleep</code></td>
<td>Delay the current thread for a length of time controlled by the sleeptime option. The default is 30 seconds. See sleeptime option.</td>
</tr>
<tr>
<td><code>snap</code></td>
<td>Snap all active trace buffers to a file in the current working directory. The file name has the format: <code>Snapnnnn.yyyymmdd.hhmmssth.ppppp.trc</code>, where <em>nnnn</em> is the sequence number of the snap file since VM startup, <em>yyyymmdd</em> is the date, <em>hhmmssth</em> is the time, and <em>ppppp</em> is the process ID in decimal with leading zeros removed.</td>
</tr>
<tr>
<td><code>suspend</code></td>
<td>Suspend all tracing (except for special trace points).</td>
</tr>
<tr>
<td><code>suspendthis</code></td>
<td>Increment the suspend count for this thread. If the suspend-count is greater than zero, prevent all tracing for this thread.</td>
</tr>
<tr>
<td><code>sysdump</code> (or <code>coredump</code>)</td>
<td>Produce a system dump. See <a href="../xdump/#dump-agents">Dump agents(<code>-Xdump:system</code>)</a>.</td>
</tr>
</tbody>
</table>
<p>Here are some examples of using the <code>trigger</code> option:</p>
<p>To produce a Java dump when a method is entered, specify the following command:</p>
<pre><code>-Xtrace:trigger=method{java/lang/String.getBytes,javadump}
</code></pre>
<p>To produce a system dump when a method is entered, specify the following command:</p>
<pre><code>-Xtrace:trigger=method{java/lang/String.getBytes,sysdump}
</code></pre>
<p>To produce a Java dump when a class constructor is called, specify the following command:</p>
<pre><code>&quot;-Xtrace:trigger=method{java/lang/Thread.&lt;init&gt;,javadump}&quot;
</code></pre>

<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> This trace option is enclosed in quotation marks to avoid unwanted shell expansion of some of the characters.</p>
<p>To produce a Java dump when a class static initializer is called, specify the following command:</p>
<pre><code>&quot;-Xtrace:trigger=method{java/lang/Thread.&lt;clinit&gt;,javadump}&quot;
</code></pre>

<p><i class="fa fa-pencil-square-o"></i> <strong>Note:</strong> This trace option is enclosed in quotation marks to avoid unwanted shell expansion of some of the characters.</p>
<p>To produce a Java dump when a method is entered 1000 times and 1001 times, specify the following command:</p>
<pre><code>-Xtrace:trigger=method{java/lang/String.getBytes,javadump,,1000,2}
</code></pre>
<p>To start tracing this thread when it enters any method in <code>java/lang/String</code>, and to stop tracing the thread after exiting the method, specify the following command:</p>
<pre><code>-Xtrace:resumecount=1
</code></pre>
<p>-Xtrace:trigger=method{java/lang/String.*,resumethis,suspendthis}</p>
<p>To resume all tracing when any thread enters a method in any class that starts with <em>error</em>, specify the following command:</p>
<pre><code>-Xtrace:trigger=method{*.error*,resume}
</code></pre>
<p>To trace (all threads) while the application is active; that is, not starting or shut down. (The application name is <code>HelloWorld</code>), specify the following command:</p>
<pre><code>-Xtrace:suspend,trigger=method{HelloWorld.main,resume,suspend}
</code></pre>
<p>To print a Java stack trace to the console when the mycomponent.1 tracepoint is reached, specify the following command:</p>
<pre><code>-Xtrace:print=mycomponent.1,trigger=tpnid{mycomponent.1,jstacktrace}
</code></pre>
<p>To write a Java stack trace to the trace output file when the <code>Sample.code()</code> method is called, specify the following command:</p>
<pre><code>-Xtrace:maximal=mt,output=trc.out,methods={mycompany/mypackage/Sample.code},trigger=method{mycompany/mypackage/Sample.code,jstacktrace}
</code></pre>
<h3 id="what"><code>what</code></h3>
<pre><code>-Xtrace:what
</code></pre>
<p>Shows the current trace settings</p>
<h2 id="see-also">See also</h2>
<ul>
<li><a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/trace_application.html">Application trace</a></li>
<li><a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/heapdump.html">Using Heapdump</a></li>
<li><a href="https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/javadump.html">Using Javadump</a></li>
<li><a href="../tool_jdmpview/">Dump viewer</a></li>
</ul>
<!-- ==== END OF TOPIC ==== xtrace.md ==== -->
                
                  
<!--
              
                
-->
              <!-- This block was originally in the theme's 'footer.html' partial file. It has been moved here in part to resolve issues with the footer being too large. -->
              
                <!--
* Copyright (c) 2017, 2018 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->
              
                <div class="md-footer-nav">
                  <nav class="md-footer-nav__inner md-grid">
<!-- Ignore all this to remove previous/next links in footer, but leave nav block else lose highlighting in LH navigation
                    <img alt="" src="../cr/rule.png"> [!-- Separator --]
                    
                      <a href="xtlhprefetch/" title="-XtlhPrefetch" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
                        <div class="md-flex__cell md-flex__cell--shrink">
                          <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
                        </div>
                        <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
                          <span class="md-flex__ellipsis">
                            <span class="md-footer-nav__direction">
                              Previous
                            </span>
                            -XtlhPrefetch
                          </span>
                        </div>
                      </a>
                    
                    
                      <a href="xtunevirtualized/" title="-Xtune:virtualized" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
                        <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
                          <span class="md-flex__ellipsis">
                            <span class="md-footer-nav__direction">
                              Next
                            </span>
                            -Xtune:virtualized
                          </span>
                        </div>
                        <div class="md-flex__cell md-flex__cell--shrink">
                          <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
                        </div>
                      </a>
                    
-->
                  </nav>
                </div>
              
              
            </article>
          </div>
        </div>
      </main>
      
        <!--
* Copyright (c) 2017, 2020 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->
<cite></cite>
<footer class="md-footer">

  <div class="md-footer-meta md-typeset">
    

      <!--
* Copyright (c) 2017, 2020 IBM Corp. and others
*
* This program and the accompanying materials are made
* available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution and is available at
* https://www.eclipse.org/legal/epl-2.0/ or the Apache
* License, Version 2.0 which accompanies this distribution and
* is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* This Source Code may also be made available under the
* following Secondary Licenses when the conditions for such
* availability set forth in the Eclipse Public License, v. 2.0
* are satisfied: GNU General Public License, version 2 with
* the GNU Classpath Exception [1] and GNU General Public
* License, version 2 with the OpenJDK Assembly Exception [2].
*
* [1] https://www.gnu.org/software/classpath/license.html
* [2] http://openjdk.java.net/legal/assembly-exception.html
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH
* Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
-->

  <div class="md-footer-social1">
    
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
    
      <a href="https://github.com/eclipse/openj9" class="md-footer-social__link fa fa-github"></a>
    
      <a href="https://openj9.slack.com" class="md-footer-social__link fa fa-slack"></a>
    
      <a href="https://twitter.com/openj9" class="md-footer-social__link fa fa-twitter"></a>
    
      <a href="https://stackoverflow.com/search?q=OpenJ9" class="md-footer-social__link fa fa-stack-overflow"></a>
    
  </div>

    
    <div class="md-footer-eclipse1">OpenJ9 is an Eclipse Incubator project.</div>

    <div class="md-footer-links1">
      <span class="no-wrap"><i class="fa fa-chevron-circle-right f_mini" aria-hidden="true"></i><a class="dark-link" href="http://www.eclipse.org">Eclipse Foundation website</a></span>
      &nbsp; <span class="no-wrap"><i class="fa fa-chevron-circle-right f_mini" aria-hidden="true"></i><a class="dark-link" href="http://www.eclipse.org/legal/privacy.php">Privacy policy</a></span>
      &nbsp; <span class="no-wrap"><i class="fa fa-chevron-circle-right f_mini" aria-hidden="true"></i><a class="dark-link" href="http://www.eclipse.org/legal/termsofuse.php">Website terms of use</a></span>
      &nbsp; <span class="no-wrap"><i class="fa fa-chevron-circle-right f_mini" aria-hidden="true"></i><a class="dark-link" href="http://www.eclipse.org/legal/copyright.php">Copyright agent</a></span>
      &nbsp; <span class="no-wrap"><i class="fa fa-chevron-circle-right f_mini" aria-hidden="true"></i><a class="dark-link" href="http://www.eclipse.org/legal">Legal</a></span>
    </div>

    <div class="md-footer-power1">
      powered by
      <a href="http://www.mkdocs.org" title="MkDocs">MkDocs</a>
      and
      <a href="http://squidfunk.github.io/mkdocs-material/" title="Material for MkDocs">
      Material for MkDocs</a><br/><br/>
    </div>

  </div>

</footer>
      
    </div>
    
      <script src="../assets/javascripts/application.a8b5e56f.js"></script>
      
        
      <script>app.initialize({version:"1.0.4",url:{base:".."}})</script>
      
    
<script>
  window.ga = window.ga || function() {
    (ga.q = ga.q || []).push(arguments)
  }
  ga.l = +new Date
  /* Setup integration and send page view */
  ga("create", "UA-105616558-3", "mkdocs.org")
  ga("set", "anonymizeIp", true)
  ga("send", "pageview")
  /* Register handler to log search on blur */
  document.addEventListener("DOMContentLoaded", () => {
    if (document.forms.search) {
      var query = document.forms.search.query
      query.addEventListener("blur", function() {
        if (this.value) {
          var path = document.location.pathname;
          ga("send", "pageview", path + "?q=" + this.value)
        }
      })
    }
  })
</script>
<script async src="https://www.google-analytics.com/analytics.js"></script>
      
    
  </body>
</html>