171 lines
6.0 KiB
HTML
171 lines
6.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>Convert Pfr Thread Data (CVTPFRTHD)</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="CVTPFRTHD.Top_Of_Page"></a>
|
||
|
|
<h2>Convert Pfr Thread Data (CVTPFRTHD)</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="#CVTPFRTHD.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CVTPFRTHD.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CVTPFRTHD.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CVTPFRTHD"></a>
|
||
|
|
<p>The Convert Performance Thread (CVTPFRTHD) command converts job performance data records. It supports data collected by the STRPFRMON (Start Performance Monitor) command or data generated by the CRTPFRDTA (Create Performance Data) command.
|
||
|
|
</p>
|
||
|
|
<p>The specified member (MBR parameter) of file QAPMJOBS or QAPMJOBL contains records with thread-level performance data. You can use CVTPFRTHD to convert this data and write the resulting records to a member by the same name (MBR parameter) in file QAPMTJOB. The output file member will contain records with job-level performance data which are a total of the performance information for all threads running within the job.
|
||
|
|
</p>
|
||
|
|
<p>The input file (QAPMJOBS or QAPMJOBL) must exist in the library specified on the LIB parameter. If file QAPMTJOB does not exist in the specified library (LIB parameter), it will be created automatically. A file member by the name specified (MBR parameter) will be automatically added to file QAPMTJOB if it did not already exist.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CVTPFRTHD.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="#CVTPFRTHD.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="#CVTPFRTHD.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="#CVTPFRTHD.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CVTPFRTHD.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the member of file QAPMJOBS or file QAPMJOBL that contains the collections to be processed. This member will be created, if it does not already exist, or replaced in QAPMTJOB file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member containing thread-level performance data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CVTPFRTHD.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies the library where the input file resides, and where the QAPMTJOB file either resides or will be created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
||
|
|
<dd>IBM-supplied performance data library QPFRDATA is to be used to locate the input database file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the input database file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CVTPFRTHD.REPLACE"></a>
|
||
|
|
<h3>Replace (REPLACE)</h3>
|
||
|
|
<p>Specifies whether the specified member in file QAPMTJOB will be replaced.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>If the member did not exist before, it is created. If the member already exists, the data contained in it is replaced.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>If the member did not exist before, it is created. If the member already exists, the data contained in it is not replaced and an error message is signalled.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CVTPFRTHD.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CVTPFRTHD MBR(MYDATA)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command converts performance data records. Member MYDATA in file QAPMJOBL or file QAPMJOBS in library QPFRDATA contains the collections to be processed.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CVTPFRTHD.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF0A83</b></dt>
|
||
|
|
<dd>Performance thread data not converted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF0A84</b></dt>
|
||
|
|
<dd>Member already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF0A85</b></dt>
|
||
|
|
<dd>User profile &1 is not authorized to library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2110</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2817</b></dt>
|
||
|
|
<dd>Copy command ended because of error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5030</b></dt>
|
||
|
|
<dd>Partial damage on member &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9810</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9812</b></dt>
|
||
|
|
<dd>File &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CVTPFRTHD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|