244 lines
9.4 KiB
HTML
244 lines
9.4 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 From Directory (CPYFRMDIR)</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="CPYFRMDIR.Top_Of_Page"></a>
|
||
|
|
<h2>Copy From Directory (CPYFRMDIR)</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="#CPYFRMDIR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CPYFRMDIR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CPYFRMDIR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CPYFRMDIR"></a>
|
||
|
|
<p>The Copy From Directory (CPYFRMDIR) command is used to copy system distribution directory data from the local system to a tape or diskette unit. This directory data can then be copied to other remote systems by using the Copy To Directory (CPYTODIR) command on the remote systems. This function allows the remote system to begin a directory shadowing environment with the local system by shadowing changes made to the directory data from the local 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> The user must have security administrator (*SECADM) authority to use this command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CPYFRMDIR.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="#CPYFRMDIR.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="#CPYFRMDIR.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="#CPYFRMDIR.SYSNAME"><b>SYSNAME</b></a></td>
|
||
|
|
<td valign="top">System name</td>
|
||
|
|
<td valign="top">Values (up to 50 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYFRMDIR.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="#CPYFRMDIR.SEQNBR"><b>SEQNBR</b></a></td>
|
||
|
|
<td valign="top">Sequence number</td>
|
||
|
|
<td valign="top">1-9999, <b><u>*END</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYFRMDIR.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>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CPYFRMDIR.EXPDATE"><b>EXPDATE</b></a></td>
|
||
|
|
<td valign="top">File expiration date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*PERM</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CPYFRMDIR.LABEL"></a>
|
||
|
|
<h3>File label (LABEL)</h3>
|
||
|
|
<p>Specifies the name that identifies the device file label on the tape or diskette to be copied. A maximum of 17 characters can be specified for tape devices and 8 characters for diskette units.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.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>diskette-device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the diskette unit to be used for the copy operation.
|
||
|
|
</dd>
|
||
|
|
<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>
|
||
|
|
</dl>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.SYSNAME"></a>
|
||
|
|
<h3>System name (SYSNAME)</h3>
|
||
|
|
<p>Specifies the names of the remote systems that copy the system distribution directory data from the tapes or diskettes created by this command. The names of the remote systems on this parameter are added to the list of system names that are collecting changes to directory data from the local system.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You must include the names of all the remote systems that use the tapes or diskettes created by this command to ensure that all changes to directory data are sent to the remote systems during a normal shadowing session.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies the sequence number of the data file on the tape being processed. The four-position file sequence number is read from the first header label of the data file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>The copy operation begins after the last sequence number on the tape volume.
|
||
|
|
</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 0001 through 9999.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.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="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CPYFRMDIR.EXPDATE"></a>
|
||
|
|
<h3>File expiration date (EXPDATE)</h3>
|
||
|
|
<p>Specifies the expiration date. The files cannot be overwritten until the expiration date. The expiration date must be later than or equal to the current date.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PERM</u></b></dt>
|
||
|
|
<dd>The data file is permanently protected. An expiration date of 999999 is assigned.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>expiration-date</i></b></dt>
|
||
|
|
<dd>Specify the date when protection for the file ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYFRMDIR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CPYFRMDIR DEV(TAP01) SYSNAME(CHICAGO NEWYORK)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command copies all of the directory data from the local system to tape device TAP01. CHICAGO and NEWYORK are added to the list of systems that collect changes to the directory data from the local system.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CPYFRMDIR.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="#CPYFRMDIR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|