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

327 lines
14 KiB
HTML
Raw Permalink 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>Create NWS Storage Space (CRTNWSSTG)</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="CRTNWSSTG.Top_Of_Page"></a>
<h2>Create NWS Storage Space (CRTNWSSTG)</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="#CRTNWSSTG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTNWSSTG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTNWSSTG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTNWSSTG"></a>
<p>The Create Network Server Storage Space (CRTNWSSTG) command creates a storage space used by a network server. The network storage space must be linked to a network server description before it can be used. For more information see the Add Network Server Storage Link (ADDNWSSTGL) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTNWSSTG.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="#CRTNWSSTG.NWSSTG"><b>NWSSTG</b></a></td>
<td valign="top">Network server storage space</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.NWSSIZE"><b>NWSSIZE</b></a></td>
<td valign="top">Size</td>
<td valign="top"><i>Integer</i>, <b><u>*CALC</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.FROMNWSSTG"><b>FROMNWSSTG</b></a></td>
<td valign="top">From storage space</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.FORMAT"><b>FORMAT</b></a></td>
<td valign="top">Format</td>
<td valign="top"><b><u>*NTFS</u></b>, *FAT, *FAT32, *OPEN, *NTFSQR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.ASP"><b>ASP</b></a></td>
<td valign="top">Auxiliary storage pool ID</td>
<td valign="top">1-255, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.ASPDEV"><b>ASPDEV</b></a></td>
<td valign="top">ASP device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.CLUDMN"><b>CLUDMN</b></a></td>
<td valign="top">Cluster domain name</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CRTNWSSTG.CLUPORTCFG"><b>CLUPORTCFG</b></a></td>
<td valign="top">Cluster port configuration</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Connection port</td>
<td valign="top">
*VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
</tr>
<tr>
<td valign="top">Element 2: Cluster internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Cluster subnet mask</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#CRTNWSSTG.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTNWSSTG.NWSSTG"></a>
<h3>Network server storage space (NWSSTG)</h3>
<p>Specify the name of the network server storage space to be created.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.NWSSIZE"></a>
<h3>Size (NWSSIZE)</h3>
<p>Specifies the size of the network server storage space to be created.
</p>
<dl>
<dt><b><u>*CALC</u></b></dt>
<dd>If the FROMNWSSTG parameter is *NONE, and a format of *NTFS is specified, the storage space size will be set to '2' MB. When *FAT32 is specified, the storage space size will be set to '512' MB. When *FAT or *OPEN is specified, the size will be set to '1' MB. When *NTFSQR is specified, the storage space size will be set to '500' MB.
<p>If a valid network server storage space name has been specified in the FROMNWSSTG parameter, the new storage space will be created with the same size as the storage space specified in the FROMNWSSTG parameter.
</p>
</dd>
<dt><b><i>1-1024000</i></b></dt>
<dd>Specify the size for the network server storage space, in megabytes.
<ul>
<li>The range for FORMAT types *NTFS, *FAT, *FAT32, and *OPEN is from 1 to 1024000 megabytes.
</li>
<li>The range for FORMAT(*NTFSQR) is from 500 to 1024000 megabytes.
</li>
</ul>
<p>When a FROMNWSSTG network server storage space is specified, the NWSSIZE parameter must be set equal to or greater than the size of the network server storage space specified in the FROMNWSSTG parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.FROMNWSSTG"></a>
<h3>From storage space (FROMNWSSTG)</h3>
<p>Specifies the name of an existing network server storage space that will be copied to the new network server storage space.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A copy operation from an existing network server storage space will not be performed.
</dd>
<dt><b><i>'name'</i></b></dt>
<dd>An existing network server storage space name used to copy to the new network server storage space being created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.FORMAT"></a>
<h3>Format (FORMAT)</h3>
<p>When a storage space is initially created, it is not formatted by the system. The storage space will need to be linked to a network server description and formatted by the hosted operating system.
</p>
<dl>
<dt><b><u>*NTFS</u></b></dt>
<dd>The storage space should be formatted using Windows NT File System. Storage spaces created with this format can be linked to network server descriptions with connection types of *IXSVR, *ISCSI or *GUEST. This option offers the greatest benefit in a Windows server environment because of its better performance and integrated support of long filenames, larger disks, extended file attributes, file-security and recoverability features.
<p>This option offers the greatest benefit in a Windows server environment because of its better performance and integrated support of long filenames, larger disks, extended file attributes, file-security and recoverability features. The size (NWSSIZE) parameter for a NTFS storage space must be at least 2 megabytes.
</p>
</dd>
<dt><b>*FAT</b></dt>
<dd>The storage space should be formatted using the File Allocation Table file system. Storage spaces created with this format can be linked to network server descriptions with connection types of *IXSVR, *ISCSI, or *GUEST.
<p>In most cases, however, greater efficiency and space utilization are achieved using the NTFS file system for Windows operating system types.
</p>
</dd>
<dt><b>*FAT32</b></dt>
<dd>The storage space should be formatted using the 32-bit File Allocation Table file system. Storage spaces created with this format can be linked to network server descriptions with connection types of *IXSVR, *ISCSI, or *GUEST.
<p>It includes support of long filenames and larger disk sizes. The size (NWSSIZE) parameter for a FAT32 storage space must be at least 512 megabytes.
</p>
</dd>
<dt><b>*OPEN</b></dt>
<dd>The storage space should be formatted with an open file source file system. Storage spaces with this format can be linked to network server descriptions with Linux or AIX operating systems only.
</dd>
<dt><b>*NTFSQR</b></dt>
<dd>The storage space should be formatted using Windows NT File System. Storage spaces created with this format will contain special attributes which makes it only linkable as a quorum resource disk used for Windows clustering.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.ASP"></a>
<h3>Auxiliary storage pool ID (ASP)</h3>
<p>Specifies the auxiliary storage pool (ASP) that will contain the new network server storage space.
</p>
<p>
<b>Note: </b>You cannot specify a value for both the ASP and ASPDEV parameters.
</p>
<dl>
<dt><b><u>'1'</u></b></dt>
<dd>The network server storage space is created in the system auxiliary pool ASP 1.
</dd>
<dt><b><i>ASP-number</i></b></dt>
<dd>The network server storage space is created in user auxiliary storage pool 2-32 or in independent auxiliary storage pools 33-255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.ASPDEV"></a>
<h3>ASP device (ASPDEV)</h3>
<p>Specifies the name of the auxiliary storage pool (ASP) device where storage is allocated for the network server storage space.
</p>
<p>
<b>Note: </b>The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
</p>
<p>
<b>Note: </b>You cannot specify a value for both the ASP and ASPDEV parameters.
</p>
<dl>
<dt><b><i>ASP-device-name</i></b></dt>
<dd>The device name of the ASP to use for the network server storage space.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.CLUDMN"></a>
<h3>Cluster domain name(CLUDMN)</h3>
<p>Specifies the domain name of the cluster. This is the domain where the cluster service account will be created.
</p>
<p>
<b>Note: </b>This parameter is required when FORMAT(*NTFSQR) is specified.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.CLUPORTCFG"></a>
<h3>Cluster port configuration(CLUPORTCFG)</h3>
<p>Specifies the TCP/IP configuration values that are specific to the cluster service. This information consists of three parts including the identification of the cluster connection port, the cluster internet address, and the cluster subnet mask.
</p>
<p>
<b>Note: </b>This parameter is required when FORMAT(*NTFSQR) is specified.
</p>
<p><b>Element 1: Connection port</b>
</p>
<p>Specifies the virtual ethernet port to be configured for this cluster. This connection will be used as a private cluster connection between each cluster node.
</p>
<p><b>Element 2: Cluster internet address</b>
</p>
<p>Specifies the internet address of this cluster. The internet address is specified in the form, <i>nnn.nnn.nnn.nnn</i> where <i>nnn</i> is a decimal number ranging from 0 through 255. An internet address that has a binary value of all ones or all zeros for the network identifier (ID) portion or the host ID portion of the internet address is not valid.
</p>
<p><b>Element 3: Cluster subnet mask</b>
</p>
<p>Specifies the subnet mask associated with cluster internet address. Subnetting provides the capability to partition an internet domain. Specify the mask for the network subnet and host address fields of the internet address that defines a subnet. The subnet mask is in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTNWSSTG.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text describing the storage space.
</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="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNWSSTG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Create NTFS-format Storage Space</b>
</p>
<p>
<pre>
CRTNWSSTG NWSSTG(STGSPACE3) NWSSIZE(200) FORMAT(*NTFS)
</pre>
</p>
<p>This command creates a network server storage space called STGSPACE3 with a size of 200 megabytes. The storage space will not be formatted and must be linked to a network server description with a connection type of *IXSVR, *ISCSI or *GUEST.
</p>
<p><b>Example 2: Copy Existing Storage Space</b>
</p>
<p>
<pre>
CRTNWSSTG NWSSTG(STGSPACE4) NWSSIZE(*CALC)
FROMNWSSTG(FROMSTG) ASP(3)
</pre>
</p>
<p>This command creates a network server storage space called STGSPACE4 with a size and format the same as FROMSTG and copies the contents into STGSPACE4. It will be created in user auxiliary storage pool (ASP) 3.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTNWSSTG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA42D</b></dt>
<dd>Storage space &amp;1 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTNWSSTG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>