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

181 lines
5.6 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>Convert To Folder (CVTTOFLR)</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="CVTTOFLR.Top_Of_Page"></a>
<h2>Convert To Folder (CVTTOFLR)</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="#CVTTOFLR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CVTTOFLR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CVTTOFLR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CVTTOFLR"></a>
<p>The Convert To Folder (CVTTOFLR) command converts a virtual disk into a folder and PC documents. The files and directories on the virtual disk are copied into the specified folder, which becomes the root directory.
</p>
<p>
<b>Note: </b>Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.
</p>
<h3>Error messages for CVTTOFLR</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IWS1613</b></dt>
<dd>Virtual disk converted. Errors occurred.
</dd>
<dt><b>IWS1614</b></dt>
<dd>Unable to convert virtual disk to folder.
</dd>
</dl>
<p><b><u>*STATUS Messages</u></b>
</p>
<dl>
<dt><b>IWS1621</b></dt>
<dd>Converting virtual disk to folder.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CVTTOFLR.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="#CVTTOFLR.FROMVDSK"><b>FROMVDSK</b></a></td>
<td valign="top">From virtual disk</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 virtual disk</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"><a href="#CVTTOFLR.TOFLR"><b>TOFLR</b></a></td>
<td valign="top">To folder</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CVTTOFLR.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace documents</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CVTTOFLR.FROMVDSK"></a>
<h3>From virtual disk (FROMVDSK)</h3>
<p>Specifies the name and library of the virtual disk that is converted.
</p>
<p>This is a required parameter.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the virtual disk.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the virtual disk. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the virtual disk is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CVTTOFLR.TOFLR"></a>
<h3>To folder (TOFLR)</h3>
<p>Specifies the name of the folder that the virtual disk is converted to. This can be a fully qualified path name.
</p>
<p>All the files and directories in the virtual disk are converted. All folders except the last folder in the path must already exist. If the last folder does not exist, it is created.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CVTTOFLR.REPLACE"></a>
<h3>Replace documents (REPLACE)</h3>
<p>Specifies if an existing document should be replaced when a file on the virtual disk has the same name as the document.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>It is not replaced.
</dd>
<dt><b>*YES</b></dt>
<dd>The existing document is replaced by the file from the virtual disk.
<p><b>Warning:</b>
</p>
<p>All documents that have the same name as files on the virtual disk will be replaced without any error messages being sent.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CVTTOFLR.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CVTTOFLR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IWS1613</b></dt>
<dd>Virtual disk converted. Errors occurred.
</dd>
<dt><b>IWS1614</b></dt>
<dd>Unable to convert virtual disk to folder.
</dd>
</dl>
<p><b><u>*STATUS Messages</u></b>
</p>
<dl>
<dt><b>IWS1621</b></dt>
<dd>Converting virtual disk to folder.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CVTTOFLR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>