249 lines
8.8 KiB
HTML
249 lines
8.8 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Analyze Java Virtual Machine (ANZJVM)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="ANZJVM.Top_Of_Page"></a>
|
|
<h2>Analyze Java Virtual Machine (ANZJVM)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#ANZJVM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ANZJVM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ANZJVM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ANZJVM"></a>
|
|
<p>The Analyze Java Virtual Machine (ANZJVM) command collects information about the Java Virtual Machine (JVM) for a specified job. A set of JVM information is collected immediately when the command is run. This collected JVM data is called a snapshot. A second snapshot is taken a specified amount of time later. By taking a snapshot of the JVM and comparing the data with a snapshot taken at a later time, the data can be analyzed to help find object leaks. The information is dumped using printer file QSYSPRT. The user data for the QSYSPRT file is 'ANZJVM'. The dump includes formatted information about the JVM heap. Details include names of classes, number of active objects per class, and the class loader used to load each class.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command uses the Start Service Job (STRSRVJOB) and Start Debug (STRDBG) commands. The user of this command must be authorized to those commands.
|
|
</li>
|
|
<li>This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
|
|
</li>
|
|
<li>This command must be run under a user profile that is the same as the job user identity of the JVM job, or that has use (*USE) authority to the job user identity of the JVM job.
|
|
</li>
|
|
<li>This command is not allowed if the remote service operation has been started for another job and that job is not the same job specified on this command.
|
|
</li>
|
|
<li>This command is not allowed if the JVM job is held, suspended, or ending.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ANZJVM.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#ANZJVM.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#ANZJVM.INTERVAL"><b>INTERVAL</b></a></td>
|
|
<td valign="top">Time interval</td>
|
|
<td valign="top">0-3600, <b><u>60</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ANZJVM.FRCGC"><b>FRCGC</b></a></td>
|
|
<td valign="top">Force garbage collection</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ANZJVM.SORT"><b>SORT</b></a></td>
|
|
<td valign="top">Sort by</td>
|
|
<td valign="top"><b><u>*NUMOBJCHG</u></b>, *NUMOBJ, *SIZECHG, *SIZE, *NAME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ANZJVM.DUPJOBOPT"><b>DUPJOBOPT</b></a></td>
|
|
<td valign="top">Duplicate job option</td>
|
|
<td valign="top"><b><u>*SELECT</u></b>, *MSG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ANZJVM.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job where the JVM is running. If no job number is given, all of the jobs currently in the system are searched for the simple job name. The job name entered must be a job in which a JVM is currently running.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRVJOB</u></b></dt>
|
|
<dd>Information about the JVM in the job currently being serviced will be dumped. If no job is currently being serviced, then a job identifier is required.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the JVM job.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the name of the user of the JVM job.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the number of the JVM job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ANZJVM.INTERVAL"></a>
|
|
<h3>Time interval (INTERVAL)</h3>
|
|
<p>Specifies the time interval in seconds between the snapshots of the JVM to be analyzed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>60</u></b></dt>
|
|
<dd>Sixty seconds will pass between JVM snapshots of data.
|
|
</dd>
|
|
<dt><b><i>0-3600</i></b></dt>
|
|
<dd>Specify the maximum number of seconds that will pass between JVM snapshots of data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ANZJVM.FRCGC"></a>
|
|
<h3>Force garbage collection (FRCGC)</h3>
|
|
<p>Specifies if a garbage collection cycle should be forced to take place.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd> A garbage collection cycle will take place before each snapshot of data is collected.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No garbage collection cycle will be forced to take place while collecting the data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ANZJVM.SORT"></a>
|
|
<h3>Sort by (SORT)</h3>
|
|
<p>Specifies the order in which the information is sorted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NUMOBJCHG</u></b></dt>
|
|
<dd>Information is sorted by the number of objects changed.
|
|
</dd>
|
|
<dt><b>*NUMOBJ</b></dt>
|
|
<dd>Information is sorted by the number of objects in the first snapshot.
|
|
</dd>
|
|
<dt><b>*SIZECHG</b></dt>
|
|
<dd>Information is sorted by the change in the amount of space used by the object.
|
|
</dd>
|
|
<dt><b>*SIZE</b></dt>
|
|
<dd>Information is sorted by the amount of space used by the object.
|
|
</dd>
|
|
<dt><b>*NAME</b></dt>
|
|
<dd>Information is sorted by the class name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ANZJVM.DUPJOBOPT"></a>
|
|
<h3>Duplicate job option (DUPJOBOPT)</h3>
|
|
<p>Specifies the action taken when duplicate jobs are found by this command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SELECT</u></b></dt>
|
|
<dd>The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, an escape message is issued.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>An escape message is issued when duplicate jobs are found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ANZJVM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ANZJVM JOB(099246/FRED/QJVACMDSRV) INTERVAL(60)
|
|
</pre>
|
|
</p>
|
|
<p>This command will collect two snapshots of the Java Virtual Machine (JVM), 60 seconds apart, for the job with job name QJVACMDSRV, user name FRED, and job number 099246. The analyzed data from the snapshots is written to a spooled file. The spooled file name will be QSYSPRT and the spooled file user data text will be ANZJVM.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ANZJVM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>JVAB602</b></dt>
|
|
<dd>Job parameter required.
|
|
</dd>
|
|
<dt><b>JVAB603</b></dt>
|
|
<dd>Unable to open print file.
|
|
</dd>
|
|
<dt><b>JVAB605</b></dt>
|
|
<dd>ANZJVM failed with reason code &1.
|
|
</dd>
|
|
<dt><b>JVAB60A</b></dt>
|
|
<dd>Job not found.
|
|
</dd>
|
|
<dt><b>CPF1938</b></dt>
|
|
<dd>Command is not allowed while serviced job is not active.
|
|
</dd>
|
|
<dt><b>CPF3524</b></dt>
|
|
<dd>More than one job with specified name found.
|
|
</dd>
|
|
<dt><b>CPF3536</b></dt>
|
|
<dd>Job completed and cannot be serviced.
|
|
</dd>
|
|
<dt><b>CPF3938</b></dt>
|
|
<dd>Already servicing another job.
|
|
</dd>
|
|
<dt><b>CPF9824</b></dt>
|
|
<dd>Not authorized to command &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ANZJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|