<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="generate-jvm-report-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)generate-jvm-report.1 1.11 07/07/27 SMI; -->
<refmeta><refentrytitle>generate-jvm-report</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>generate<option>jvm</option><option>report</option></primary>
</indexterm><indexterm><primary>shows the threads, classes and memory for
a given target instance</primary></indexterm>
<refname>generate-jvm-report</refname><refpurpose>shows the threads, classes
and memory for a given target instance.</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>generate-jvm-report</command> &synopsis-common; [target] [--type=<replaceable>
summary|memory|class|thread</replaceable>]</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This command shows the threads (dump of stack trace), classes and memory
for a given target instance, including the Domain Administration Service.
This command works only with the se<?Pub Caret>rver instance processes. This
command replaces the traditional techniques like sending ctrl+break or kill
-3 signals to processes. The command will not work if the target server instance
is not running.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">type</option></term>
<listitem><para>The type of report user wants to see. </para>
<itemizedlist>
<listitem><para><literal>summary</literal>, which displays summary information
about the threads/classes and memory.</para></listitem>
<listitem><para><literal>memory</literal>, which provides information about
heap and non-heap memory consumption, memory pools, and garbage collection
statistics for a given target instance</para></listitem>
<listitem><para><literal>classes</literal>, which gives information about
the class loader for a given target instance</para></listitem>
<listitem><para><literal>threads</literal>, which provides information about
threads running and the thread dump (stack trace) for a given target instance.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">target</option></term>
<listitem><para>This option specifies the ending location of the connector
resources. </para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target.  <literal>server</literal> is the name of the default
server instance and is the default value.</para></listitem>
<listitem><para><replaceable>domain_name</replaceable>&hyphen; Specifies a
certain domain as the target.</para></listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a certain cluster as the target.</para></listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a certain server instance as the target.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using the generate-jvm-report command</title>
<screen>asadmin> <userinput>generate-jvm-report --user admin --passwordfile passwords.txt
--type summary server1</userinput>
Operating System Information:
Name of the Operating System: Linux
Binary Architecture name of the Operating System: i386, Version: 
2.6.9-22.ELsmp
Number of processors available on the Operating System: 2
...
...
...
user.language = en
user.name = root
user.timezone = America/Los_Angeles
Command generate-jvm-report executed successfully</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>
