223 lines
7.0 KiB
HTML
223 lines
7.0 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 Trace (DMPTRC)</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="DMPTRC.Top_Of_Page"></a>
|
|
<h2>Dump Trace (DMPTRC)</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="#DMPTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DMPTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DMPTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DMPTRC"></a>
|
|
<p>The Dump Trace (DMPTRC) command copies data from the vertical microcode (VMC) trace table to a database file. You can run the job interactively or submit it as a batch job. (Batch jobs will run under the submitter's job description and user profile.)
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) CL command or the Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
|
|
</li>
|
|
<li>The following user profiles have authority to this command:
|
|
<ul>
|
|
<li>QSRV
|
|
</li>
|
|
<li>QPGMR
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DMPTRC.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"><a href="#DMPTRC.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPTRC.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DMPTRC.JOBQ"><b>JOBQ</b></a></td>
|
|
<td valign="top">Job queue</td>
|
|
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job queue</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QCTL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QSYS</u></b>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DMPTRC.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DMPTRC.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member of the database file in which the trace table data is to be dumped.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the database file member to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPTRC.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the library where the database file for trace data is located. If the file is not found in the specified library, the system automatically creates it in that library.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
|
<dd>IBM-supplied performance data library QPFRDATA is to be used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPTRC.JOBQ"></a>
|
|
<h3>Job queue (JOBQ)</h3>
|
|
<p>Specifies the job queue to be used if you want this Dump Trace (DMPTRC) command to run as a batch job.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No job is submitted. The DMPTRC request runs interactively.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QCTL</u></b></dt>
|
|
<dd>Job queue QCTL is to be used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job queue to be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QSYS</u></b></dt>
|
|
<dd>The IBM-supplied system library, QSYS, is used to locate the job queue.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All libraries in the library list for the current job are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPTRC.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the database member.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DMPTRC MBR(TUESAM)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes existing VMC trace data to be written to the member TUESAM in library QPFRDATA. The file used is QAPMDMPT. The request is submitted to the job queue QCTL in library QSYS. It runs as a batch job.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0A81</b></dt>
|
|
<dd>Performance trace cannot be sent to database file.
|
|
</dd>
|
|
<dt><b>CPF0A82</b></dt>
|
|
<dd>Performance trace cannot be sent to database file.
|
|
</dd>
|
|
<dt><b>CPF2110</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF3307</b></dt>
|
|
<dd>Job queue &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF7207</b></dt>
|
|
<dd>Not able to start &2. Return code &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|