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/crtntwvol.htm

307 lines
11 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>Create NetWare Volume (CRTNTWVOL)</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="CRTNTWVOL.Top_Of_Page"></a>
<h2>Create NetWare Volume (CRTNTWVOL)</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="#CRTNTWVOL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTNTWVOL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTNTWVOL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTNTWVOL"></a>
<p>The Create NetWare Volume (CRTNTWVOL) command creates a volume for the specified network server. The network server must be active at the time this command is run. The space is allocated from the device number.
</p>
<p>This command causes the following to happen:
</p>
<ol>
<li>The physical volume is created on the specified device.
</li>
<li>For NetWare 4+, the volume object, which represents the physical volume, is automatically placed into the NDS (NetWare Directory Services) tree. The volume object is put into the same container as the server object which represents the network server.
</li>
<li>The volume is mounted if specified.
</li>
</ol>
<p>The following restrictions apply for NetWare volumes:
</p>
<ul>
<li>A maximum of 8 segments per device is allowed. A device can have a maximum of 8 segments from the same volume or combination of different volumes.
</li>
<li>A maximum of 32 segments per volume is allowed. CRTNTWVOL will create the first segment. The Change NetWare Volume (CHGNTWVOL) command can be used, up to 31 times, to add additional segments.
</li>
<li>A maximum of 64 mounted volumes per server is allowed.
</li>
</ul>
<p><b>Restrictions:</b> You must have *IOSYSCFG special authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTNTWVOL.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="#CRTNTWVOL.VOL"><b>VOL</b></a></td>
<td valign="top">Volume</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.SIZE"><b>SIZE</b></a></td>
<td valign="top">Size of volume</td>
<td valign="top">1-8000, <b><u>*MAXAVAIL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.DEVNBR"><b>DEVNBR</b></a></td>
<td valign="top">Device number</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.SEGNBR"><b>SEGNBR</b></a></td>
<td valign="top">Segment number</td>
<td valign="top">0-14, <b><u>*ANY</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.BLKSIZE"><b>BLKSIZE</b></a></td>
<td valign="top">Block size</td>
<td valign="top"><b><u>*DFT</u></b>, 4, 8, 16, 32, 64</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">Data compression</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.BLKSUBALC"><b>BLKSUBALC</b></a></td>
<td valign="top">Block suballocation</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.MOUNT"><b>MOUNT</b></a></td>
<td valign="top">Mount</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNTWVOL.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*VOL</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTNTWVOL.VOL"></a>
<h3>Volume (VOL)</h3>
<p>Specifies the physical volume to be created. By default, the name of the volume object placed into the NDS tree is <b>servername_volumename</b>. The volume name must be 2 - 15 characters long and must be unique within the directory tree.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.SERVER"></a>
<h3>Server (SERVER)</h3>
<p>Specifies the server for which the volume is being created. This network server must be active when this command is executed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.SIZE"></a>
<h3>Size of volume (SIZE)</h3>
<p>Specifies the size of the volume to be created, in megabytes.
</p>
<dl>
<dt><b><u>*MAXAVAIL</u></b></dt>
<dd>Use the size of the largest area of contiguous free space on the specified device.
</dd>
<dt><b><i>1-8000</i></b></dt>
<dd>Specify the size of the volume in megabytes. The size specified must be no larger than the largest area of contiguous free space on the device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.DEVNBR"></a>
<h3>Device number (DEVNBR)</h3>
<p>Specifies the device number from which the storage for the volume is allocated. A value of 0 to 99 is allowed to be specified. Use Work with Netware Volumes (WRKNTWVOL) command to find an available device number.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.SEGNBR"></a>
<h3>Segment number (SEGNBR)</h3>
<p>Specifies the number of the segment which the new volume is allocated.
</p>
<dl>
<dt><b><u>*ANY</u></b></dt>
<dd>Use the first segment which has the available size requested.
</dd>
<dt><b><i>0-14</i></b></dt>
<dd>Specify the number of the segment from which the storage for the new volume is to be allocated. Use WRKNTWVOL (F10=Show Segments) to determine which segments are free and available for use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.BLKSIZE"></a>
<h3>Block size (BLKSIZE)</h3>
<p>Specifies the block size of the data in the volume. This value cannot be changed once the volume is created. Volume blocks are the smallest piece of data the server can access in a volume. The larger the block size, the greater the potential for wasted memory. However, if the majority of files are very large, a large block size may be more efficient. Turning on block suballocation will aid in minimizing waste. Block suballocation is controlled by the <b>Block suballocation (BLKSUBALC)</b> parameter.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Specifies to use the block size that NetWare determines by default given the size of the volume.
</dd>
<dt><b><i>block-size</i></b></dt>
<dd>Specify the block size of the data, in kilobytes. Valid values are: 4, 8, 16, 32 and 64 kilobytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.DTACPR"></a>
<h3>Data compression (DTACPR)</h3>
<p>Specifies whether or not to enable data compression for this volume. Note that once data compression is turned on for a volume, it cannot be turned off.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Data compression is enabled for this volume.
</dd>
<dt><b>*NO</b></dt>
<dd>Data compression is not enabled for this volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.BLKSUBALC"></a>
<h3>Block suballocation (BLKSUBALC)</h3>
<p>Specifies whether or not to enable block suballocation for this volume. Note that once block suballocation is turned on for a volume, it cannot be turned off.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Block suballocation is enabled for this volume.
</dd>
<dt><b>*NO</b></dt>
<dd>Block suballocation is not enabled for this volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.MOUNT"></a>
<h3>Mount (MOUNT)</h3>
<p>Specifies whether or not to mount this volume as soon as it's created. Don't mount volumes that are rarely used because each mounted volume uses some server memory. Volumes can be mounted and dismounted while the server is active.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The volume is created and then mounted.
</dd>
<dt><b>*NO</b></dt>
<dd>The volume is created but not mounted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNTWVOL.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies the text that briefly describes the volume.
</p>
<dl>
<dt><b><u>*VOL</u></b></dt>
<dd>The volume name will be used for the description of the volume.
</dd>
<dt><b><i>character-value</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="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNTWVOL.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating a Physical Volume</b>
</p>
<p>
<pre>
CRTNTWVOL VOL(APPS) SERVER(SERVER1) NWSSTG(STGSPACE1)
</pre>
</p>
<p>This command creates physical volume APPS for network server SERVER1 with the size of the largest contiguous free space available on the network server storage space. SERVER1 is a local server (a NWSD of type *NETWARE defined on the local system). The storage is allocated from storage space STGSPACE1. A volume object called SERVER1_APPS is placed into the NDS tree. The volume is mounted by default.
</p>
<p><b>Example 2: Creating a Volume with Specific Size</b>
</p>
<p>
<pre>
CRTNTWVOL VOL(VOL1) SERVER(SERVER2) DEVNBR(9)
SIZE(50) DTACPR(*YES) MOUNT(*NO)
</pre>
</p>
<p>This command creates physical volume VOL1 for network server SERVER2 with a size of 50 megabytes. This server may be local or remote. The storage is allocated from device number 9. A volume object called SERVER2_VOL1 is placed into the NDS tree. Data compression is enabled for this volume and the volume is not mounted.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNTWVOL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>FPE0107</b></dt>
<dd>Volume &amp;1 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNTWVOL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink