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

463 lines
16 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>Initialize Optical (INZOPT)</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="INZOPT.Top_Of_Page"></a>
<h2>Initialize Optical (INZOPT)</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="#INZOPT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#INZOPT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#INZOPT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="INZOPT"></a>
<p>The Initialize Optical (INZOPT) command initializes an optical volume. Depending on the type of optical volume being initialized this operation may take up to 30 minutes to complete. When an existing optical volume is initialized a second time, all existing information is lost.
</p>
<p><b>Restriction:</b> To use this command you must have *ALL authority to the authorization list securing the volume if it is in an optical media library device. You need *CHANGE authority to the authorization list securing the volume if it is in an optical device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="INZOPT.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="#INZOPT.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*MOUNTED</u></b></td>
<td valign="top">Optional, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.NEWVOL"><b>NEWVOL</b></a></td>
<td valign="top">New volume identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*VOL</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.THRESHOLD"><b>THRESHOLD</b></a></td>
<td valign="top">Volume full threshold</td>
<td valign="top">1-100, <b><u>*CALC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.CHECK"><b>CHECK</b></a></td>
<td valign="top">Check for an active volume</td>
<td valign="top">*NO, <b><u>*YES</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of media option</td>
<td valign="top"><b><u>*LEAVE</u></b>, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.CLEAR"><b>CLEAR</b></a></td>
<td valign="top">Clear</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.TYPE"><b>TYPE</b></a></td>
<td valign="top">Volume type</td>
<td valign="top"><b><u>*PRIMARY</u></b>, *BACKUP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.CCSID"><b>CCSID</b></a></td>
<td valign="top">Coded character set ID</td>
<td valign="top"><b><u>*CALC</u></b>, 500, 850</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INZOPT.MEDFMT"><b>MEDFMT</b></a></td>
<td valign="top">Media format</td>
<td valign="top"><b><u>*MEDTYPE</u></b>, *HPOFS, *UDF</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="INZOPT.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies the volume identifier of the optical volume being initialized.
</p>
<dl>
<dt><b><u>*MOUNTED</u></b></dt>
<dd>The volume mounted in the specified device (DEV parameter) will be initialized.
</dd>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the identifier of the optical volume to initialize.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.NEWVOL"></a>
<h3>New volume identifier (NEWVOL)</h3>
<p>Specifies the identifier of the optical volume after it is initialized. The identifier must contain only alphabetic characters (A through Z), numeric characters (0 through 9), hyphen (-), underscore (_), or a period (.). The first character must be alphabetic or numeric and the identifier cannot contain blanks.
</p>
<dl>
<dt><b><u>*VOL</u></b></dt>
<dd>The new volume identifier is the same as the old volume identifier.
</dd>
<dt><b><i>new-volume-identifier</i></b></dt>
<dd>Specify the new volume identifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the optical device which contains the volume to be initialized. This parameter is only required when VOL(*MOUNTED) is specified. The device cannot be an optical media library device.
</p>
<dl>
<dt><b><i>optical-device</i></b></dt>
<dd>The name of the optical device containing the volume which will be initialized.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.THRESHOLD"></a>
<h3>Volume full threshold (THRESHOLD)</h3>
<p>Specifies the percentage of space on the volume to use until the volume is considered full. This field is only used if the media format is *HPOFS. For other media formats, this field is ignored and the threshold will default to 100 percent.
</p>
<dl>
<dt><b><u>*CALC</u></b></dt>
<dd>The system will calculate the percentage of the volume to use based on media format and volume type.
<ul>
<li>For a media format of *HPOFS and a volume type of *PRIMARY the threshold will be 95 percent.
</li>
<li>For a media format of *HPOFS and a volume type of *BACKUP the threshold will be 99 percent.
</li>
<li>For a media format of *UDF the threshold will be 100 percent.
</li>
</ul>
</dd>
<dt><b><i>volume-full-threshold</i></b></dt>
<dd>Specify the volume threshold percentage. Valid values range from 1 through 100.
<p>
<b>Note: </b>If the volume type is *BACKUP, this parameter is ignored and the volume-full-threshold is set to 99 percent.
</p>
<p>If the media format is *UDF, this parameter is ignored and the volume-full-threshold is set to 100 percent.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.CHECK"></a>
<h3>Check for an active volume (CHECK)</h3>
<p>Specifies whether the system checks to see if the optical volume is initialized.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The system checks to see if the optical volume is initialized. If the volume is initialized, the operation is ended and an error message is sent.
</dd>
<dt><b>*NO</b></dt>
<dd>The system does not check to see if the optical volume is initialized. The volume will be initialized and all existing data will be lost.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.ENDOPT"></a>
<h3>End of media option (ENDOPT)</h3>
<p>Specifies whether the media is unloaded from the device after the initialize command completes.
</p>
<p>
<b>Note: </b>This parameter is ignored if the media is an optical library device.
</p>
<dl>
<dt><b><u>*LEAVE</u></b></dt>
<dd>When the initialize completes the media is left in the device.
</dd>
<dt><b>*UNLOAD</b></dt>
<dd>When the initialize completes the media is unloaded from the device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.CLEAR"></a>
<h3>Clear (CLEAR)</h3>
<p>Specifies whether or not existing data on the volume will be cleared during the initialize process. This parameter only applies when the volume media type is *DVD-RAM.
</p>
<p>
<b>Note: </b>If the volume media type is *WORM the volume is never cleared regardless of the parameter setting.
</p>
<p>If the volume media type is *ERASE the volume is always cleared regardless of the parameter setting.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The volume is not cleared.
</dd>
<dt><b>*YES</b></dt>
<dd>The volume is cleared of existing data prior to initialization.
<p>
<b>Note: </b>If this option is selected the INZOPT command may take several hours or more to complete, depending on the media capacity.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.TEXT"></a>
<h3>Volume type (TEXT)</h3>
<p>Specifies the text that briefly describes the optical volume.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.TYPE"></a>
<h3>Volume type (TYPE)</h3>
<p>Specifies the type of optical volume being initialized. Optical volumes for user applications are initialized as primary volumes. Backup optical volumes can be written to only by using the following set of optical backup commands: CVTOPTBKU, CPYOPT, and DUPOPT.
</p>
<dl>
<dt><b><u>*PRIMARY</u></b></dt>
<dd>The optical volume is used as a primary volume.
</dd>
<dt><b>*BACKUP</b></dt>
<dd>The optical volume is used as a backup volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.CCSID"></a>
<h3>Coded character set ID (CCSID)</h3>
<p>Specifies the character set in which the optical volume, directory, file names, and volume description are written. This parameter does not affect how user data is written. The user application must determine the character set in which the file data is written.
</p>
<dl>
<dt><b><u>*CALC</u></b></dt>
<dd>The system will select the default character set based on the media format.
</dd>
<dt><b>500</b></dt>
<dd>The EBCDIC character set and code page 500 are used.
</dd>
<dt><b>850</b></dt>
<dd>The ASCII character set and code page 850 are used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INZOPT.MEDFMT"></a>
<h3>Media format (MEDFMT)</h3>
<p>Indicates the media format to use when writing to the optical media. There are two media formats, either *HPOFS (High Performance Optical File System) or *UDF (Universal Disk Format). For a complete comparison of the two media formats refer to the Optical Support, SC41-4310 book.
</p>
<dl>
<dt><b><u>*MEDTYPE</u></b></dt>
<dd>Specifies that the operating system will determine which media format is used to initialize the volume. The media format will be based upon the media type.
<ul>
<li>If the media type is *WORM or *UNKNOWN, the media will be initialized using the *HPOFS format.
</li>
<li>If the media type is *ERASE and has not been previously initialized the media will be initialized using the *HPOFS format.
</li>
<li>If the media type is *ERASE and has been previously initialized it will be initialized using the previous media format.
</li>
<li>If the media type is *DVD-RAM, the media will be initialized using the *UDF format.
</li>
</ul>
</dd>
<dt><b>*HPOFS</b></dt>
<dd>The High Performance Optical File System is used to initialize the volume. One of the characteristics of HPOFS is space occupied by a deleted file is not reused. The only way deleted file space can be recovered is to reinitialize the media thereby losing all previously recorded data on the media.
</dd>
<dt><b>*UDF</b></dt>
<dd>The Universal Disk Format, a subset of the ISO 13346 standard, is used to initialize the volume. One of the characteristics of UDF is space occupied by a deleted file will be reused when needed for either the creation of a new file or the extension of an existing file. The UDF media format also provides file and directory level security through the use of permissions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INZOPT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
INZOPT VOL(VOL01) THRESHOLD(99) CHECK(*NO)
</pre>
</p>
<p>This command initializes the optical volume VOL01 with a volume-full-threshold of 99 percent. The system does not check to see if the volume is initialized.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INZOPT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>OPT1305</b></dt>
<dd>Optical volume &amp;1 is read only.
</dd>
<dt><b>OPT1315</b></dt>
<dd>Optical volume &amp;1 is write protected.
</dd>
<dt><b>OPT1320</b></dt>
<dd>Optical volume &amp;1 in use.
</dd>
<dt><b>OPT1325</b></dt>
<dd>Optical volume format not recognized.
</dd>
<dt><b>OPT1330</b></dt>
<dd>Optical volume not found or not useable.
</dd>
<dt><b>OPT1331</b></dt>
<dd>Optical volume &amp;1 not found.
</dd>
<dt><b>OPT1335</b></dt>
<dd>Volume &amp;1 already initialized.
</dd>
<dt><b>OPT1342</b></dt>
<dd>Invalid volume identifier specified.
</dd>
<dt><b>OPT1345</b></dt>
<dd>No free space available on media.
</dd>
<dt><b>OPT1346</b></dt>
<dd>Operation not allowed to volume located in a remote optical device.
</dd>
<dt><b>OPT1350</b></dt>
<dd>Write operation failed to optical volume &amp;1.
</dd>
<dt><b>OPT1360</b></dt>
<dd>Media directory corrupted on optical volume &amp;1.
</dd>
<dt><b>OPT1375</b></dt>
<dd>Optical volume &amp;1 already exists.
</dd>
<dt><b>OPT1460</b></dt>
<dd>Optical volume &amp;1 is not in an optical device.
</dd>
<dt><b>OPT1485</b></dt>
<dd>Initialize or rename of optical volume failed.
</dd>
<dt><b>OPT1489</b></dt>
<dd>Volume parameter is not permitted for device &amp;1.
</dd>
<dt><b>OPT1530</b></dt>
<dd>&amp;1 does not represent a valid optical device.
</dd>
<dt><b>OPT1540</b></dt>
<dd>Invalid parameters specified.
</dd>
<dt><b>OPT1555</b></dt>
<dd>Optical device &amp;1 in use.
</dd>
<dt><b>OPT1605</b></dt>
<dd>Media or device error occurred.
</dd>
<dt><b>OPT1790</b></dt>
<dd>Operation not allowed or conflicts with another request.
</dd>
<dt><b>OPT1805</b></dt>
<dd>Error accessing optical volume index file.
</dd>
<dt><b>OPT1810</b></dt>
<dd>Error accessing optical directory index file.
</dd>
<dt><b>OPT1815</b></dt>
<dd>Internal program error occurred.
</dd>
<dt><b>OPT1820</b></dt>
<dd>Internal error occurred on optical device &amp;1.
</dd>
<dt><b>OPT1821</b></dt>
<dd>Error occurred on optical device &amp;1.
</dd>
<dt><b>OPT1825</b></dt>
<dd>Optical indexes are incorrect for optical device &amp;1.
</dd>
<dt><b>OPT1860</b></dt>
<dd>Request to optical device &amp;1 failed.
</dd>
<dt><b>OPT1861</b></dt>
<dd>No device description configured for resource &amp;1.
</dd>
<dt><b>OPT1862</b></dt>
<dd>No active device description for resource &amp;1.
</dd>
<dt><b>OPT1863</b></dt>
<dd>Optical libraries need to be reclaimed.
</dd>
<dt><b>OPT1872</b></dt>
<dd>Optical request timed out or was cancelled.
</dd>
<dt><b>OPT2301</b></dt>
<dd>Internal system object in use.
</dd>
<dt><b>OPT2420</b></dt>
<dd>Not authorized to optical volume &amp;2.
</dd>
<dt><b>OPT2422</b></dt>
<dd>Not authorized to file or directory.
</dd>
<dt><b>OPT7740</b></dt>
<dd>User not authorized to object &amp;2 in library &amp;3 type &amp;4.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INZOPT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>