234 lines
7.8 KiB
HTML
234 lines
7.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>Convert Performance Data (CVTPFRDTA)</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="CVTPFRDTA.Top_Of_Page"></a>
|
|
<h2>Convert Performance Data (CVTPFRDTA)</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="#CVTPFRDTA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CVTPFRDTA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CVTPFRDTA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CVTPFRDTA"></a>
|
|
<p>The Convert Performance Data (CVTPFRDTA) command converts performance data from a previous release to the format needed for processing by the current release of Performance Tools for iSeries(TM).
|
|
</p>
|
|
<p>The command first determines the release level at which the data was collected. Then the members of all necessary files are converted. The conversion may be done in the same library where the current data resides. To avoid the risk of destroying the old data if the command ends abnormally, convert the data into a different library (TOLIB), and later, delete the data from the old library (FROMLIB).
|
|
</p>
|
|
<p>If the conversion is done in a different library, the old data remains in the current library (FROMLIB) and the new data resides in the new library (TOLIB). If a new library is specified for the newly converted data, all files are copied to the new library, including those files which do not need to be converted.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CVTPFRDTA.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="#CVTPFRDTA.FROMLIB"><b>FROMLIB</b></a></td>
|
|
<td valign="top">From library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTPFRDTA.TOLIB"><b>TOLIB</b></a></td>
|
|
<td valign="top">To library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CVTPFRDTA.JOBD"><b>JOBD</b></a></td>
|
|
<td valign="top">Job description</td>
|
|
<td valign="top">Single values: <b><u>*USRPRF</u></b>, *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 description</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CVTPFRDTA.FROMLIB"></a>
|
|
<h3>From library (FROMLIB)</h3>
|
|
<p>Specifies the library that contains the files to be converted.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the files to be converted are located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTPFRDTA.TOLIB"></a>
|
|
<h3>To library (TOLIB)</h3>
|
|
<p>Specifies the library where the converted files will be located.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the converted files are to be located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTPFRDTA.JOBD"></a>
|
|
<h3>Job description (JOBD)</h3>
|
|
<p>Specifies the job description used to submit jobs for batch processing.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
|
<dd>The job description specified in the user's user profile is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>A batch job is not submitted. Instead, processing continues interactively while the user waits. The user's work station is not available for other use during this time, which can be significant for long jobs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job description</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job description to be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job description. If no current library entry exists in the library list, 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="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CVTPFRDTA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Converting Data Using a Batch Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CVTPFRDTA FROMLIB(MIKE) TOLIB(TERESA)
|
|
</pre>
|
|
</p>
|
|
<p>This command converts the performance data in library MIKE and places it in library TERESA. The conversion is done by a batch job submitted using the job description associated with the user profile of the user running this command.
|
|
</p>
|
|
<p><b>Example 2: Converting Performance Data Interactively</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CVTPFRDTA FROMLIB(QPFRDATA) TOLIB(QPFRDATA) JOBD(*NONE)
|
|
</pre>
|
|
</p>
|
|
<p>This command converts the performance data in library QPFRDATA and places it in the same library after conversion is complete. This conversion occurs interactively while the user waits.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CVTPFRDTA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0A0B</b></dt>
|
|
<dd>Performance tools files did not convert.
|
|
</dd>
|
|
<dt><b>CPF22F7</b></dt>
|
|
<dd>Number of authorities must be between 1 and &1.
|
|
</dd>
|
|
<dt><b>CPF22FA</b></dt>
|
|
<dd>Authority value &1 not valid.
|
|
</dd>
|
|
<dt><b>CPF22FB</b></dt>
|
|
<dd>Must specify *EXCLUDE or *AUTL as only authority value.
|
|
</dd>
|
|
<dt><b>CPF2817</b></dt>
|
|
<dd>Copy command ended because of error.
|
|
</dd>
|
|
<dt><b>CPF4102</b></dt>
|
|
<dd>File &2 in library &3 with member &4 not found.
|
|
</dd>
|
|
<dt><b>CPF8122</b></dt>
|
|
<dd>&8 damage on library &4.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9807</b></dt>
|
|
<dd>One or more libraries in library list deleted.
|
|
</dd>
|
|
<dt><b>CPF9808</b></dt>
|
|
<dd>Cannot allocate one or more libraries on library list.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9811</b></dt>
|
|
<dd>Program &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|