295 lines
10 KiB
HTML
295 lines
10 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>Change NetWare Volume (CHGNTWVOL)</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="CHGNTWVOL.Top_Of_Page"></a>
|
||
|
<h2>Change NetWare Volume (CHGNTWVOL)</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="#CHGNTWVOL.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#CHGNTWVOL.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#CHGNTWVOL.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="CHGNTWVOL"></a>
|
||
|
<p>The Change NetWare Volume (CHGNTWVOL) command changes a volume on the specified network server. This command can be used to increase the size of the volume (by adding a new volume segment), enable data compression, enable block suballocation, mount or dismount the volume, or change the text description. 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. The Create NetWare Volume (CRTNTWVOL) command will create the first segment, CHGNTWVOL 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>The network server must be active at the time this command is run.
|
||
|
</p>
|
||
|
<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="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="CHGNTWVOL.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="#CHGNTWVOL.VOL"><b>VOL</b></a></td>
|
||
|
<td valign="top">Volume</td>
|
||
|
<td valign="top"><i>Character value</i></td>
|
||
|
<td valign="top">Required, Key, Positional 1</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.SERVER"><b>SERVER</b></a></td>
|
||
|
<td valign="top">Server</td>
|
||
|
<td valign="top"><i>Character value</i></td>
|
||
|
<td valign="top">Required, Key, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.SIZE"><b>SIZE</b></a></td>
|
||
|
<td valign="top">Size of volume</td>
|
||
|
<td valign="top">1-8000, <b><u>*SAME</u></b>, *MAXAVAIL</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.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="#CHGNTWVOL.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="#CHGNTWVOL.DTACPR"><b>DTACPR</b></a></td>
|
||
|
<td valign="top">Data compression</td>
|
||
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.BLKSUBALC"><b>BLKSUBALC</b></a></td>
|
||
|
<td valign="top">Block suballocation</td>
|
||
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.MOUNT"><b>MOUNT</b></a></td>
|
||
|
<td valign="top">Mount</td>
|
||
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CHGNTWVOL.TEXT"><b>TEXT</b></a></td>
|
||
|
<td valign="top">Text</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *VOL</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="CHGNTWVOL.VOL"></a>
|
||
|
<h3>Volume (VOL)</h3>
|
||
|
<p>Specifies the volume to be changed.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.SERVER"></a>
|
||
|
<h3>Server (SERVER)</h3>
|
||
|
<p>Specifies the network server where the volume resides. This network server must be active when this command is executed.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.SIZE"></a>
|
||
|
<h3>Size of volume (SIZE)</h3>
|
||
|
<p>Specifies the new size of the volume, in megabytes. A new volume segment will be created to increase the volume size by the desired amount. Use the Display NetWare Volume (DSPNTWVOL) command to see the device (drive) on which this volume currently resides.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*MAXAVAIL</b></dt>
|
||
|
<dd>The new size of the volume will be the current size plus the size of the largest area of contiguous free space on the specified device (DEBNBR parameter)
|
||
|
</dd>
|
||
|
<dt><b><i>1-8000</i></b></dt>
|
||
|
<dd>Specify the new size of the volume, in megabytes. The value specified must be larger than the current size of the volume; the size of a volume cannot be decreased.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.DEVNBR"></a>
|
||
|
<h3>Device number (DEVNBR)</h3>
|
||
|
<p>The device number from which the storage for the new volume segment is allocated. Use the Display NetWare Volume (DSPNTWVOL) command to see the device (drive) on which this volume currently resides.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>0-99</i></b></dt>
|
||
|
<dd>Specify the number of the device from which the storage for the new volume segment is allocated.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.SEGNBR"></a>
|
||
|
<h3>Segment number (SEGNBR)</h3>
|
||
|
<p>The number of the segment which the storage for 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 volume is to be allocated. Use the Work with NetWare Volumes (WRKNTWVOL) command (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="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.DTACPR"></a>
|
||
|
<h3>Data compression (DTACPR)</h3>
|
||
|
<p>Specifies whether or not to enable data compression for this volume.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>Compression is enabled for this volume. Note that once compression is turned on for a volume, it cannot be turned off.
|
||
|
</dd>
|
||
|
<dt><b>*NO</b></dt>
|
||
|
<dd>Compression is not enabled for this volume.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.BLKSUBALC"></a>
|
||
|
<h3>Block suballocation (BLKSUBALC)</h3>
|
||
|
<p>Specifies whether or not to enable block suballocation for this volume.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>Block suballocation is enabled for this volume. Note that once block suballocation is enabled for a volume, it cannot be turned off.
|
||
|
</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="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.MOUNT"></a>
|
||
|
<h3>Mount (MOUNT)</h3>
|
||
|
<p>Specifies whether to mount or dismount this volume. 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>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>Mount the volume.
|
||
|
</dd>
|
||
|
<dt><b>*NO</b></dt>
|
||
|
<dd>Dismount the volume.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CHGNTWVOL.TEXT"></a>
|
||
|
<h3>Text (TEXT)</h3>
|
||
|
<p>Specifies the text that briefly describes the volume.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
<dd>The value does not change.
|
||
|
</dd>
|
||
|
<dt><b>*VOL</b></dt>
|
||
|
<dd>Change the text to the volume name.
|
||
|
</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="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CHGNTWVOL.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p><b>Example 1: Enabling Commpression on a Network Server</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CHGNTWVOL VOL(APPS) SERVER(MKTING) DTACPR(*YES)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command enables compression for volume APPS which resides on network server MKTING.
|
||
|
</p>
|
||
|
<p><b>Example 2: Increasing Volume Size on a Local Server</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CHGNTWVOL VOL(APPS) SERVER(MKTING) SIZE(500)
|
||
|
NWSSTG(STGSPACE1)
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command increases the size of the APPS volume to 500 megabytes. This volume is on server MKTING which needs to be local server because NWSSTG is specified. Storage for the new volume segment is allocated from storage space STGSPACE1.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CHGNTWVOL.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>FPE010D</b></dt>
|
||
|
<dd>Volume &1 not changed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CHGNTWVOL.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|