197 lines
6.9 KiB
HTML
197 lines
6.9 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>Dump Java Virtual Machine (DMPJVM)</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="DMPJVM.Top_Of_Page"></a>
|
|
<h2>Dump Java Virtual Machine (DMPJVM)</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="#DMPJVM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DMPJVM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DMPJVM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DMPJVM"></a>
|
|
<p>The Dump Java Virtual Machine (DMPJVM) command dumps information about the Java Virtual Machine (JVM) for a specified job. The information is dumped using printer file QSYSPRT. The dump includes formatted information about the classpath, garbage collection, and threads associated with the JVM.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command uses the STRSRVJOB and 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>The issue of the command must be running under a user profile which is the same as the job user identity of the JVM job, or which 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>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DMPJVM.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="#DMPJVM.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="#DMPJVM.STACKFRAME"><b>STACKFRAME</b></a></td>
|
|
<td valign="top">Stack frames</td>
|
|
<td valign="top">0000-9999, <b><u>10</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPJVM.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="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DMPJVM.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="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPJVM.STACKFRAME"></a>
|
|
<h3>Stack frames (STACKFRAME)</h3>
|
|
<p>Specifies the maximum number of stack frames to be processed for each thread. This value must be greater than zero and cannot be greater than 100. If there are more than the specified number of frames on a thread's stack, the more recent frames on the stack are processed and '...' is used to indicate that not all of the stack frames were processed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>10</u></b></dt>
|
|
<dd>A maximum of ten stack frames will be processed for each thread.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All stack frames will be processed for each thread. If a thread has more than 100 stack frames, only the first 100 frames will be processed.
|
|
</dd>
|
|
<dt><b><i>1-100</i></b></dt>
|
|
<dd>Specify the maximum number of stack frames that will be processed for each thread.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPJVM.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="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPJVM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DMPJVM JOB(099246/FRED/QJVACMDSRV)
|
|
</pre>
|
|
</p>
|
|
<p>This command will dump information for the Java Virtual Machine for the job with job name QJVACMDSRV, user name FRED, and job number 099246.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPJVM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>JVAB601</b></dt>
|
|
<dd>DMPJVM failed with reason code &1.
|
|
</dd>
|
|
<dt><b>JVAB602</b></dt>
|
|
<dd>Job parameter required.
|
|
</dd>
|
|
<dt><b>JVAB603</b></dt>
|
|
<dd>Unable to open print file.
|
|
</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="#DMPJVM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|