ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/cpygphfmt.htm

191 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>Copy Graph Format (CPYGPHFMT)</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="CPYGPHFMT.Top_Of_Page"></a>
<h2>Copy Graph Format (CPYGPHFMT)</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="#CPYGPHFMT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYGPHFMT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYGPHFMT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYGPHFMT"></a>
<p>The Copy Graph Format (CPYGPHFMT) command copies an existing graph format into a graph format specified by the user.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYGPHFMT.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="3"><a href="#CPYGPHFMT.FROMFMT"><b>FROMFMT</b></a></td>
<td valign="top">From format</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: From format</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>QPFRDATA</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CPYGPHFMT.TOFMT"><b>TOFMT</b></a></td>
<td valign="top">To format</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: To format</td>
<td valign="top"><i>Name</i>, <b><u>*FROMFMT</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*FROMLIB</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CPYGPHFMT.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYGPHFMT.FROMFMT"></a>
<h3>From format (FROMFMT)</h3>
<p>Specifies the graph format from which the copy is to be created.
</p>
<p>This is a required parameter.
</p>
<dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>QPFRDATA</u></b></dt>
<dd>The IBM-supplied performance library, QPFRDATA, is where the copy of the graph format is located.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the graph format. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the graph format is located.
</dd>
</dl>
<dt><b><i>format-name</i></b></dt>
<dd>Specify the name of the graph format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYGPHFMT.TOFMT"></a>
<h3>To format (TOFMT)</h3>
<p>Specifies the graph format location where the copy is to be created.
</p>
<dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*FROMLIB</u></b></dt>
<dd>The graph format is located in the library specified on the FROMFMT parameter.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is where the copy of the graph format will be located. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the copy of the graph format will be located.
</dd>
</dl>
<dt><b><u>*FROMFMT</u></b></dt>
<dd>The graph format name specified on the FROMFMT parameter is used.
</dd>
<dt><b><i>format-name</i></b></dt>
<dd>Specify the name of the copy of the graph format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYGPHFMT.REPLACE"></a>
<h3>Replace (REPLACE)</h3>
<p>Specifies whether to replace the graph format in the <b>To format</b> prompt (TOFMT parameter) if the graph format already exists.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The existing graph format is not replaced with the new graph format.
</dd>
<dt><b>*YES</b></dt>
<dd>The existing graph format is replaced with the new graph format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYGPHFMT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Sending a Copy to the Default Library</b>
</p>
<p>
<pre>
CPYGPHFMT FROMFMT(MYFMT) TOFMT(YOURFMT)
</pre>
</p>
<p>This command makes a copy of MYFMT and sends it to YOURFMT in the QPFRDATA library.
</p>
<p><b>Example 2: Sending a Copy to a Specified Library</b>
</p>
<p>
<pre>
CPYGPHFMT FROMFMT(MYLIB/FMT1) TOFMT(YOURLIB/FMT2)
</pre>
</p>
<p>This command makes a copy of FMT1 in the MYLIB library and sends it to FMT2 in the YOURLIB library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYGPHFMT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>PFR9043</b></dt>
<dd>&amp;1 does not exist in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYGPHFMT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>