526 lines
18 KiB
HTML
526 lines
18 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 Spooled File (CPYSPLF)</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="CPYSPLF.Top_Of_Page"></a>
|
||
|
|
<h2>Copy Spooled File (CPYSPLF)</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="#CPYSPLF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CPYSPLF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CPYSPLF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CPYSPLF"></a>
|
||
|
|
<p>The Copy Spooled File (CPYSPLF) command copies the data records in the specified spooled file to a user-defined physical database file. This conversion allows the use of spooled files in applications using microfiche, data communications, or data processing. Print lines that are all blank are not copied. When you copy a spooled file to a physical file, certain information is lost or changed. For example:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Graphics data is lost.
|
||
|
|
</li>
|
||
|
|
<li>Bar code data is lost.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CPYSPLF.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="#CPYSPLF.FILE"><b>FILE</b></a></td>
|
||
|
|
<td valign="top">Spooled file</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CPYSPLF.TOFILE"><b>TOFILE</b></a></td>
|
||
|
|
<td valign="top">To data base file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: To data base 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="4"><a href="#CPYSPLF.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job name</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: User</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 3: Number</td>
|
||
|
|
<td valign="top">000000-999999</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CPYSPLF.SPLNBR"><b>SPLNBR</b></a></td>
|
||
|
|
<td valign="top">Spooled file number</td>
|
||
|
|
<td valign="top">1-999999, <b><u>*ONLY</u></b>, *LAST, *ANY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYSPLF.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
|
||
|
|
<td valign="top">Job system name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CPYSPLF.CRTDATE"><b>CRTDATE</b></a></td>
|
||
|
|
<td valign="top">Spooled file created</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Creation date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Creation time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYSPLF.TOMBR"><b>TOMBR</b></a></td>
|
||
|
|
<td valign="top">To member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYSPLF.MBROPT"><b>MBROPT</b></a></td>
|
||
|
|
<td valign="top">Replace or add records</td>
|
||
|
|
<td valign="top"><b><u>*REPLACE</u></b>, *ADD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYSPLF.CTLCHAR"><b>CTLCHAR</b></a></td>
|
||
|
|
<td valign="top">Control character</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *FCFC, *PRTCTL, *S36FMT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CPYSPLF.CHLVAL"><b>CHLVAL</b></a></td>
|
||
|
|
<td valign="top">Channel values</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NORMAL</u></b><br>Other values (up to 12 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Channel</td>
|
||
|
|
<td valign="top">
|
||
|
|
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Line</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-255</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CPYSPLF.FILE"></a>
|
||
|
|
<h3>Spooled file (FILE)</h3>
|
||
|
|
<p>Specifies the spooled file that is to be copied to a database file.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the file name of the spooled file to be copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.TOFILE"></a>
|
||
|
|
<h3>To data base file (TOFILE)</h3>
|
||
|
|
<p>Specifies a user-defined physical database file to which the spooled records will be copied. If this file does not exist at the time of the copy, the copy will fail.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: To data base file</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the file name of the physical file to receive the copy.
|
||
|
|
</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 file. If no current library entry exists in the library list, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the job that created the spooled file whose data records are to be copied.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The job that issued this command is the job that created the spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the job that created the spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: User</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user name that identifies the user profile under which the job is run.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 3: Number</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>000000-999999</i></b></dt>
|
||
|
|
<dd>Specify the system-assigned job number.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.SPLNBR"></a>
|
||
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
||
|
|
<p>Specifies the number of the spooled file, from the job whose data records are to be copied.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>Only one spooled file in the job has the specified file name; therefore, the number of the spooled file is not necessary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the highest number and the specified file name is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The spooled file number is not used to determine which spooled file is used. Use this value when the job system name parameter or the spooled file create date and time parameter is to take precedence over the spooled file number when selecting a spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-999999</i></b></dt>
|
||
|
|
<dd>Specify the number of the spooled file whose data records are to be copied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.JOBSYSNAME"></a>
|
||
|
|
<h3>Job system name (JOBSYSNAME)</h3>
|
||
|
|
<p>Specifies the name of the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file create date and time.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and create date and time is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The job system name is not used to determine which spooled file is used. Use this value when the spooled file create date and time parameter is to take precedence over the job system name when selecting a spooled file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the system where the job that created the spooled file ran.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.CRTDATE"></a>
|
||
|
|
<h3>Spooled file created (CRTDATE)</h3>
|
||
|
|
<p>Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest create date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Creation date</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Creation time</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest create time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the time the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.TOMBR"></a>
|
||
|
|
<h3>To member (TOMBR)</h3>
|
||
|
|
<p>Specifies the name of the file member that receives the copied records.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The first member of the specified file is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member of the physical file. If this member does not exist, a member is created and the copy continues.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.MBROPT"></a>
|
||
|
|
<h3>Replace or add records (MBROPT)</h3>
|
||
|
|
<p>Specifies whether the new records replace or are added to the existing records.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*REPLACE</b></dt>
|
||
|
|
<dd>The system clears the existing member and adds the new records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ADD</b></dt>
|
||
|
|
<dd>The system adds the new records to the end of the existing records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.CTLCHAR"></a>
|
||
|
|
<h3>Control character (CTLCHAR)</h3>
|
||
|
|
<p>Specifies which print control characters (if any) are to replace the spooled file's internal print control characters.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No print control characters are created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FCFC</b></dt>
|
||
|
|
<dd>Specifies that the first character of every record contains one of the ANSI forms control codes listed in the CL Reference manual. This option may be useful for microfiche production.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRTCTL</b></dt>
|
||
|
|
<dd>Specifies that the first four characters of every record contains skip- and space-before values useful in high-level language programs. This code can be viewed as SSSL, where SSS is the skip-before line value and L is the space-before value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*S36FMT</b></dt>
|
||
|
|
<dd>Specifies that the format of the records to be copied to a database file is the same as that created on the IBM System/36 for COPYPRT. This value is not allowed for spooled files which exist on primary or secondary auxiliary storage pools.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYSPLF.CHLVAL"></a>
|
||
|
|
<h3>Channel values (CHLVAL)</h3>
|
||
|
|
<p>Specifies a list of channel numbers with their assigned line numbers. Specify this parameter only if *FCFC is specified on the <b>Control character (CTLCHAR)</b> parameter). Channel number refers to a method of determining skipping for reports. Each assigned channel must have a corresponding line number to provide the correct positioning on a report.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NORMAL</u></b></dt>
|
||
|
|
<dd>Indicates channel 1 is the only assigned channel number. The assigned line number for channel 1 is line 1.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 12 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Channel</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>channel-number</i></b></dt>
|
||
|
|
<dd>Specify which channels are used to control skipping on a report. The only valid values for this parameter are 1 through 12. Each channel number can be specified only once per Copy Spooled File (CPYSPLF) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Line</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-255</i></b></dt>
|
||
|
|
<dd>The line number assigned for the channel number in the same list. The range of valid line numbers is 1 through 255. Each line number can be specified only once per Copy Spooled File (CPYSPLF) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYSPLF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Replacing Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CPYSPLF FILE(QPRINT) JOB(PAYROLL01) SPLNBR(4)
|
||
|
|
TOFILE(MYFILE) TOMBR(MYMBR) CTLCHAR(*PRTCTL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>In this example, file QPRINT (which is the fourth file produced by job PAYROLL01) is copied to member MYMBR of physical file MYFILE (which resides in a library found by searching the library list). The newly copied data replaces all old data in the member because all old records have been cleared. The 4-byte print control code is created.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Adding Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CPYSPLF FILE(QPRINT) TOFILE(MYLIB/MYFILE) JOB(PAYROLL02)
|
||
|
|
MBROPT(*ADD) CTLCHAR(*FCFC) CHLVAL((1 3) (4 15))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>In this example, file QPRINT (the only file of that name left in job PAYROLL02) is copied to the first member of the physical file found in library MYLIB. The newly copied data is added to data existing in the member. The FCFC 1-byte print control character is used and takes advantage of the assigned channel values in formatting the output. The assigned channel values as specified on the command are as follows:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Line 3 assigned to channel 1
|
||
|
|
</li>
|
||
|
|
<li>Line 15 assigned to channel 4
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYSPLF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2207</b></dt>
|
||
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3207</b></dt>
|
||
|
|
<dd>Member not added. Errors occurred.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3303</b></dt>
|
||
|
|
<dd>File &1 not found in job &5/&4/&3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3309</b></dt>
|
||
|
|
<dd>No files named &1 are active.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3311</b></dt>
|
||
|
|
<dd>Copy request failed for file &6 in &7.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3330</b></dt>
|
||
|
|
<dd>Necessary resource not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3340</b></dt>
|
||
|
|
<dd>More than one file with specified name found in job &5/&4/&3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3342</b></dt>
|
||
|
|
<dd>Job &5/&4/&3 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3343</b></dt>
|
||
|
|
<dd>Duplicate job names found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3344</b></dt>
|
||
|
|
<dd>File &1 number &8 no longer in the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF338A</b></dt>
|
||
|
|
<dd>Control character *S36FMT not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3394</b></dt>
|
||
|
|
<dd>Cannot convert spooled file data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3429</b></dt>
|
||
|
|
<dd>File &1 number &7 cannot be displayed, copied, or sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3482</b></dt>
|
||
|
|
<dd>Copy request failed. Spool file &1 is open.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3483</b></dt>
|
||
|
|
<dd>Copy request failed for file &6 in &7.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3486</b></dt>
|
||
|
|
<dd>CHLVAL parameter value not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3492</b></dt>
|
||
|
|
<dd>Not authorized to spooled file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3493</b></dt>
|
||
|
|
<dd>CTLCHAR parameter not correct for file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3499</b></dt>
|
||
|
|
<dd>Records in file &1 preceded all assigned channel values.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5812</b></dt>
|
||
|
|
<dd>Member &3 already exists in file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9812</b></dt>
|
||
|
|
<dd>File &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9837</b></dt>
|
||
|
|
<dd>Attempt made to override file &1 to MBR(*ALL).
|
||
|
|
</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="#CPYSPLF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|