175 lines
5.8 KiB
HTML
175 lines
5.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>End Performance Trace (ENDPFRTRC)</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="ENDPFRTRC.Top_Of_Page"></a>
|
|
<h2>End Performance Trace (ENDPFRTRC)</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="#ENDPFRTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDPFRTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDPFRTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDPFRTRC"></a>
|
|
<p>The End Performance Trace (ENDPFRTRC) command will stop the collection of performance trace data in the QPM_STRPFRTRC trace table and optionally write performance trace data to a data base file. The QPM_STRPFRTRC trace table will be deleted whether or not the data is written to a data base file.
|
|
</p>
|
|
<p>This command is intended to be used to end a performance trace started via the Start Performance Trace (STRPFRTRC) command. However, it will end and try to process any active trace in the QPM_STRPFRTRC trace table.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following user profiles have private authorities to use the command:
|
|
<ul>
|
|
<li>QSRV
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDPFRTRC.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="#ENDPFRTRC.DMPTRC"><b>DMPTRC</b></a></td>
|
|
<td valign="top">Dump the trace</td>
|
|
<td valign="top">*NO, <b><u>*YES</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDPFRTRC.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDPFRTRC.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"><a href="#ENDPFRTRC.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="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDPFRTRC.DMPTRC"></a>
|
|
<h3>Dump the trace (DMPTRC)</h3>
|
|
<p>Specifies whether the trace data is to be dumped to the performance database file QAPMDMPT. If the data is not dumped, it will be lost when the trace table is deleted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The trace data, if any, is dumped.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The trace data is not dumped.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDPFRTRC.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member within the QAPMDMPT database file where the trace table data is to be dumped. A value must be specified for this parameter if *YES is specified for the <b>Dump the trace (DMPTRC)</b> 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="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDPFRTRC.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 to locate the database file for trace data.
|
|
</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="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDPFRTRC.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="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDPFRTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Ending Performance Trace</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDPFRTRC DMPTRC(*YES) MBR(MYDATA)
|
|
</pre>
|
|
</p>
|
|
<p>In this example, the current trace is ended, the data is written to member MYDATA of file QAPMDMPT in library QPFRDATA, and the trace table is deleted, releasing the storage used by the trace.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDPFRTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<p>Refer to the TRCINT and DMPTRC commands for messages.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|