friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/cpytodir.htm

249 lines
9.5 KiB
HTML
Raw Blame History

<!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 To Directory (CPYTODIR)</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="CPYTODIR.Top_Of_Page"></a>
<h2>Copy To Directory (CPYTODIR)</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="#CPYTODIR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYTODIR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYTODIR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYTODIR"></a>
<p>The Copy To Directory (CPYTODIR) command is used to copy system distribution directory data from a tape or diskette unit to the local system. The directory data that is copied to the local system is created by the Copy From Directory (CPYFRMDIR) command on a remote system. This function allows the local system to begin a directory shadowing environment with the remote system by shadowing changes made to the directory data from the remote system.
</p>
<p><b>Caution:</b> Do not use this command as a backup utility to save and restore directory data for data recovery purposes. Follow the normal backup and recovery procedure guidelines described in the Backup and Recovery book, SC41-5304.
</p>
<p><b>Restriction:</b> You must have security administrator (*SECADM) authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYTODIR.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="#CPYTODIR.LABEL"><b>LABEL</b></a></td>
<td valign="top">File label</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top">Values (up to 4 repetitions): <i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.AUTOINZ"><b>AUTOINZ</b></a></td>
<td valign="top">Automatically initialize</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.RPLDTA"><b>RPLDTA</b></a></td>
<td valign="top">Replace data</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top">Single values: *NONE<br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-9999, <b><u>*NEXT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYTODIR.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of tape option</td>
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYTODIR.LABEL"></a>
<h3>File label (LABEL)</h3>
<p>Specifies the device file label on the tape or diskette used for the copy operation. A maximum of 17 characters can be specified for tape devices; a maximum of 8 characters can be specified for diskette unit.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the names of the tape or diskette units used for the copy operation. Each tape or diskette unit name must already be known on the system by a device description.
</p>
<dl>
<dt><b><i>tape-device-name</i></b></dt>
<dd>Specify the names of one or more tape devices used for the copy operation. If more than one tape device is used, specify the names of the devices in the order in which they are used. When more than one tape volume is used, using more than one tape device permits one tape volume to be rewound or unloaded while another tape device processes the next tape volume.
</dd>
<dt><b><i>diskette-device-name</i></b></dt>
<dd>Specify the name of the diskette unit to be used for the copy operation.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.AUTOINZ"></a>
<h3>Automatically initialize (AUTOINZ)</h3>
<p>Specifies whether to automatically pass the information copied to this system to other collector systems through directory shadowing.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The directory entries copied are automatically supplied to collector systems.
</dd>
<dt><b>*NO</b></dt>
<dd>The directory entries copied are not supplied to other collector systems that have already been initialized.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.RPLDTA"></a>
<h3>Replace data (RPLDTA)</h3>
<p>Specifies whether to replace a directory entry on the local system with directory data copied from tape or diskette.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Shadowed data is copied from tape or diskette, but directory entries are not replaced with copied directory data if the directory entry exists on the system.
</dd>
<dt><b>*YES</b></dt>
<dd>All directory data is copied from tape or diskette. A directory entry replaces an entry for the same user that already exists on the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies one or more volume identifiers used by the file.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No volume identifiers are specified for the file. No volume identifiers are checked.
</dd>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the identifiers of one or more volumes in the order in which they are placed in a device and used for the copy operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the data file on the tape that is processed. The four-position file sequence number is read from the first header label of the data file.
</p>
<dl>
<dt><b><u>*NEXT</u></b></dt>
<dd>The copy operation begins on the next file on the tape volume. If the tape is currently positioned before the first file, the first file from the tape is processed.
</dd>
<dt><b><i>file-sequence-number</i></b></dt>
<dd>Specify the sequence number of the file that is used. Valid values range from 1 through 9999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYTODIR.ENDOPT"></a>
<h3>End of tape option (ENDOPT)</h3>
<p>Specifies the operation that is automatically performed on the tape volume after the operation ends. If more than one volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.
</p>
<dl>
</dl>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*LEAVE</b></dt>
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*UNLOAD</b></dt>
<dd>The tape is automatically rewound and unloaded after the operation ends.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYTODIR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CPYTODIR DEV(DKT01) AUTOINZ(*YES) RPLDTA(*NO)
</pre>
</p>
<p>This command copies all of the directory data from diskette device DKT01 to the local system. Data that is copied to the local system is passed along to other systems that use communications to perform directory shadow initializing or normal directory shadowing. Local system data identified as being the same as diskette data is not replaced.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYTODIR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF90A8</b></dt>
<dd>*SECADM special authority required to do requested operation.
</dd>
<dt><b>CPF90FB</b></dt>
<dd>Directory data not copied because of errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYTODIR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink