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

181 lines
6.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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 Optical File (CPYOFRDAR)</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="CPYOFRDAR.Top_Of_Page"></a>
<h2>Copy Optical File (CPYOFRDAR)</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="#CPYOFRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYOFRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYOFRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYOFRDAR"></a>
<p>The Copy Optical File (CPYOFRDAR) command copies a database file member to an optical file. Copy operations can be done from a physical or logical database member. You may copy data to a physical or logical optical file. No mapping of fields between the files is done by the copy operation. Therefore the data in both files must have the same field layouts and types. Records are always added to any existing records in the optical file.
</p>
<p>
<b>Note: </b>File overrides are not supported by this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYOFRDAR.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="#CPYOFRDAR.FROMFILE"><b>FROMFILE</b></a></td>
<td valign="top">From database file</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 database file</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><tr>
<td valign="top" rowspan="3"><a href="#CPYOFRDAR.TOFILE"><b>TOFILE</b></a></td>
<td valign="top">To optical file</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 optical file</td>
<td valign="top"><i>Name</i>, <b><u>*FROMFILE</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CPYOFRDAR.FROMMBR"><b>FROMMBR</b></a></td>
<td valign="top">From database file member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYOFRDAR.FROMFILE"></a>
<h3>From database file (FROMFILE)</h3>
<p>Specifies the name of the database file from which records are copied (the source database file).
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: From database file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source database file.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is where the file is located. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the source database file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYOFRDAR.TOFILE"></a>
<h3>To optical file (TOFILE)</h3>
<p>Specifies the name of the optical file to which records are copied (the target optical file).
</p>
<p><b>Qualifier 1: To optical file</b>
</p>
<dl>
<dt><b><u>*FROMFILE</u></b></dt>
<dd>The name of the target optical file is the same as the name of the source database file as specified on the FROMFILE parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the target optical file.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is where the file is located. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the target optical file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYOFRDAR.FROMMBR"></a>
<h3>From database file member (FROMMBR)</h3>
<p>Specifies the database member in the from-file that is being copied.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the database from-file is copied.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the database from-file member to copy.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYOFRDAR.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYOFRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>RDR5415</b></dt>
<dd>Member &amp;3 in File &amp;1 in &amp;2 not copied to Optical File &amp;4 in &amp;5.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYOFRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>