234 lines
8.3 KiB
HTML
234 lines
8.3 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 User Trace (DMPUSRTRC)</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="DMPUSRTRC.Top_Of_Page"></a>
|
|
<h2>Dump User Trace (DMPUSRTRC)</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="#DMPUSRTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DMPUSRTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DMPUSRTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DMPUSRTRC"></a>
|
|
<p>The Dump User Trace Buffer (DMPUSRTRC) command formats trace records in the user trace buffer for the specified job. The formatted trace records can be written to a database file or to the <b>stdout</b> special file.
|
|
</p>
|
|
<p>Trace records are written to a user trace buffer using the Qp0zUprintf, Qp0zDump, Qp0zDumpStack, and Qp0zDumpTargetStack APIs. Refer to the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter, <b>OS/400 UNIX-type APIs</b> for more information on the Problem Determination APIs.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DMPUSRTRC.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="#DMPUSRTRC.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <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="#DMPUSRTRC.TRCRCID"><b>TRCRCID</b></a></td>
|
|
<td valign="top">Trace record identifiers</td>
|
|
<td valign="top">Values (up to 2 repetitions): <b><u>*THD</u></b>, *JOB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPUSRTRC.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*FILE</u></b>, *STDOUT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPUSRTRC.SLTTHD"><b>SLTTHD</b></a></td>
|
|
<td valign="top">Thread IDs to include</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 8 repetitions): <i>Hexadecimal value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPUSRTRC.OMTTHD"><b>OMTTHD</b></a></td>
|
|
<td valign="top">Thread IDs to exclude</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 8 repetitions): <i>Hexadecimal value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DMPUSRTRC.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the job for which the user trace buffer is being dumped.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The user trace buffer for the job that the command is running in is dumped.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the job whose user trace buffer is being dumped. If no user name or job number qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a qualified job name must be specified.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the name of the user of the job whose user trace buffer is being dumped.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the six-digit number of the job whose user trace buffer is being dumped.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPUSRTRC.TRCRCID"></a>
|
|
<h3>Trace record identifiers (TRCRCID)</h3>
|
|
<p>Specifies the record identifiers to be used in the formatted tracepoint records. Up to two identifiers can be specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*THD</u></b></dt>
|
|
<dd>Thread identifiers are used. Each identifier contains eight hexadecimal digits.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>Job identifiers are used. Each identifier contains the six-digit job number portion of the qualified job name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPUSRTRC.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies where the output from the command is directed to.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FILE</u></b></dt>
|
|
<dd>The output is written to member QP0Znnnnnn in database file QAP0ZDMP in library QTEMP where 'nnnnnn' is the six-digit job number portion of the qualified job name.
|
|
</dd>
|
|
<dt><b>*STDOUT</b></dt>
|
|
<dd>The output is written to the <b>stdout</b> special file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPUSRTRC.SLTTHD"></a>
|
|
<h3>Thread IDs to include (SLTTHD)</h3>
|
|
<p>Specifies a list of up to eight threads whose trace records are to be included. Only trace records for threads with the specified thread identifiers are included.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the OMTTHD parameter are mutually exclusive.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All trace records are included, unless excluded by another selection value.
|
|
</dd>
|
|
<dt><b><i>thread-identifier</i></b></dt>
|
|
<dd>Specify the thread identifiers of up to eight threads whose trace records are to be included.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPUSRTRC.OMTTHD"></a>
|
|
<h3>Thread IDs to exclude (OMTTHD)</h3>
|
|
<p>Specifies a list of up to eight threads whose trace records are to be excluded. Trace records for all threads except those specified are included.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the SLTTHD parameter are mutually exclusive.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No trace records are excluded based on their thread identifier.
|
|
</dd>
|
|
<dt><b><i>thread-identifier</i></b></dt>
|
|
<dd>Specify the thread identifiers of up to eight threads whose trace records are to be excluded.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPUSRTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Dumping the Current User Trace Information</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DMPUSRTRC
|
|
</pre>
|
|
</p>
|
|
<p>This command formats the user trace information for the current job and writes the formatted trace records to file QAP0ZDMP in library QTEMP.
|
|
</p>
|
|
<p><b>Example 2: Dumping a Trace for a Specific Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DMPUSRTRC JOB(004842/ACCT/WS6) OUTPUT(*STDOUT)
|
|
</pre>
|
|
</p>
|
|
<p>This command formats the user trace information for job WS6, which is associated with the user profile ACCT, and has the job number 004842, writing the formatted trace records to the <i>stdout</i> special file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPUSRTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA98B</b></dt>
|
|
<dd>The User Trace buffer associated with job &3/&2/&1 could not be dumped.
|
|
</dd>
|
|
<dt><b>CPFA98C</b></dt>
|
|
<dd>Job &3/&2/&1 not unique.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPUSRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|