341 lines
15 KiB
HTML
341 lines
15 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>Add Server Storage Link (ADDNWSSTGL)</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="ADDNWSSTGL.Top_Of_Page"></a>
|
|
<h2>Add Server Storage Link (ADDNWSSTGL)</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="#ADDNWSSTGL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDNWSSTGL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDNWSSTGL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDNWSSTGL"></a>
|
|
<p>The Add Network Server Storage Link (ADDNWSSTGL) command is used to add a network storage space link to a network server description.
|
|
</p>
|
|
<p><b>When *IXSVR is specified for the </b><b>Network server type (TYPE)</b><b> parameter in CRTNWSD command:</b>
|
|
</p>
|
|
<ol>
|
|
<li>A maximum of 16 network server storage spaces can be linked to a network server description when using standard linking (DYNAMIC *NO specified).
|
|
<p>An additional 32 storage spaces may be dynamically linked to a Windows 2000 server or later with 16 of the 32 links being linked with *UPDATE access ( read/write to only one server ). The remaining 16 links are available for *SHRUPD access ( read/write to multiple clustered Windows Server 2000 or later servers ). The first of these *SHRUPD access links must be to a quorum resource disk ( format *NTFSQR ) at DRVSEQNBR *QR.
|
|
</p>
|
|
<p>This is only valid when <b>*WIN32</b> is specified for the <b>Network server type (TYPE)</b> parameter.
|
|
</p>
|
|
</li>
|
|
<li>A maximum of 64 network server storage spaces can be linked to a network server description when using dynamic linking (DYNAMIC *YES specified). The first two storage spaces (1 and 2) must be linked with *UPDATE access (read/write). This is only valid when <b>*LINUX32</b> is specified for the <b>Network server type (TYPE)</b> parameter.
|
|
</li>
|
|
</ol>
|
|
<p><b>When *ISCSI is specified for the </b><b>Network server type (TYPE)</b><b> parameter in CRTNWSD command:</b>
|
|
</p>
|
|
<p>A maximum of 64 network server storage spaces can be linked to a network server description when using dynamic linking. The first two storage spaces (1 and 2) must be linked with *UPDATE access (read/write).
|
|
</p>
|
|
<ol>
|
|
<li>Storage spaces 3-63 can be linked with *UPDATE or *SHRUPD access mode. The last of the 64 storage spaces (64th) must be *SHRUPD access to a quorum resource ( format *NTFSQR ) at DRVSEQNBR *QR when <b>*WIN32</b> is specified for the <b>Network server type (TYPE)</b> parameter.
|
|
</li>
|
|
<li>Storage spaces 3-64 can be linked with *UPDATE or *SHRUPD access mode when <b>*LINUX32</b> is specified for the <b>Network server type (TYPE)</b> parameter.
|
|
</li>
|
|
</ol>
|
|
<p><b>When </b><b>*GUEST</b><b> is specified for the </b><b>Network server type (TYPE)</b><b> parameter in CRTNWSD command:</b>
|
|
</p>
|
|
<ol>
|
|
<li>A maximum of 64 network server storage spaces can be linked in any access mode to a network server description when using dynamic linking.
|
|
</li>
|
|
</ol>
|
|
<p>For more information about adding a link to a specific server type, see the following:
|
|
</p>
|
|
<ul>
|
|
<li>For <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter in NWSD object - Windows environment on iSeries information in iSeries Information Center at http://www.iseries.ibm.com/infocenter book.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDNWSSTGL.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="#ADDNWSSTGL.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="#ADDNWSSTGL.NWSD"><b>NWSD</b></a></td>
|
|
<td valign="top">Network server description</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNWSSTGL.DYNAMIC"><b>DYNAMIC</b></a></td>
|
|
<td valign="top">Dynamic storage link</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNWSSTGL.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Network server type</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NWSD</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNWSSTGL.ACCESS"><b>ACCESS</b></a></td>
|
|
<td valign="top">Access</td>
|
|
<td valign="top"><b><u>*UPDATE</u></b>, *READ, *SHRUPD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNWSSTGL.DRVSEQNBR"><b>DRVSEQNBR</b></a></td>
|
|
<td valign="top">Drive sequence number</td>
|
|
<td valign="top">1-64, <b><u>*CALC</u></b>, *QR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNWSSTGL.STGPTHNBR"><b>STGPTHNBR</b></a></td>
|
|
<td valign="top">Storage path number</td>
|
|
<td valign="top">1-4, <b><u>*DFTSTGPTH</u></b>, *MLTPTHGRP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDNWSSTGL.NWSSTG"></a>
|
|
<h3>Network server storage space (NWSSTG)</h3>
|
|
<p>Specifies the name of the network server storage space.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.NWSD"></a>
|
|
<h3>Network server description (NWSD)</h3>
|
|
<p>Specifies the name of the network server description to which this link is to be added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.DYNAMIC"></a>
|
|
<h3>Dynamic storage link (DYNAMIC)</h3>
|
|
<p>Specifies whether this storage is to be linked as dynamic storage using the next available location, or linked as static storage using the drive sequence number specified by the DRVSEQNBR parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The storage space is linked in the standard linking method using the DRVSEQNBR parameter. The NWSD must be in a VARIED OFF state to perform this operation.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The storage space is linked using dynamic linking. It will use the next available sequence number.
|
|
<p>
|
|
<b>Note: </b>If the Network server description (NWSD) was created with *IXSVR or *ISCSI specified for the <b>Network server type (TYPE)</b> parameter, DYNAMIC parameter will be ignored and considered *YES when the server is installed with Windows 2000 or later, or Linux. If the NWSD was created with *GUEST specified for the <b>Network server type (TYPE)</b> parameter, DYNAMIC parameter will be ignored and considered *YES.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.TYPE"></a>
|
|
<h3>Network server type (TYPE)</h3>
|
|
<p>Describes the type of network server description to which this link is added.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is present only for compatibility with previous releases. The value specified is not syntax checked and no verification is done to ensure that the network server description matches the specified TYPE value.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.ACCESS"></a>
|
|
<h3>Access (ACCESS)</h3>
|
|
<p>Specifies the server's access method to the storage space.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*UPDATE</u></b></dt>
|
|
<dd>The storage space is accessed in READ/WRITE mode. The storage space can be written to by the server.
|
|
</dd>
|
|
<dt><b>*READ</b></dt>
|
|
<dd>The storage space is accessed in READ-only mode. Write requests to the storage space are not allowed from this server. Multiple servers may be linked to this storage space.
|
|
</dd>
|
|
<dt><b>*SHRUPD</b></dt>
|
|
<dd>The storage space is accessed in shared update mode. The storage space can be written to by the server. Multiple servers may be linked to this storage space. Disks linked to servers in a Windows cluster must be linked as *SHRUPD.
|
|
<p>
|
|
<b>Note: </b>DYNAMIC(*YES) must be specified when ACCESS(*SHRUPD) is specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.DRVSEQNBR"></a>
|
|
<h3>Drive sequence number (DRVSEQNBR)</h3>
|
|
<p>Specifies the order in which the network storage spaces are presented to the server. Each storage space must be given a unique sequence number.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CALC</u></b></dt>
|
|
<dd>The system will assign the lowest available sequence number.
|
|
</dd>
|
|
<dt><b>*QR</b></dt>
|
|
<dd>The special value used for linking the quorum disk for a Windows cluster.
|
|
<p>This value must be used when linking a *NTFSQR format disk as the quorum disk for a Windows cluster. The quorum disk must be linked with ACCESS(*SHRUPD) and it must be the first *SHRUPD link when *IXSVR is specified for the <b>Network server type (TYPE)</b> parameter, or must be the last (64th) when *ISCSI is specified for the <b>Network server type (TYPE)</b> parameter in the CRTNWSD command. Each server in a Windows cluster must be linked to one and only one quorum resource disk. The quorum must also be linked to each server with DYNAMIC(*YES) specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>1-64</i></b></dt>
|
|
<dd>When network server created with <b>Server connection *IXSVR</b> and <b>Server operating system *WIN32</b>:
|
|
<ol>
|
|
<li>When DYNAMIC(*YES) and ACCESS(*SHRUPD) is specified, a value between 1 and 15 must be specified.
|
|
</li>
|
|
<li>When DYNAMIC(*YES) and ACCESS is *UPDATE, a value between 1 and 16 must be specified.
|
|
</li>
|
|
<li>When DYNAMIC(*NO) is specified, a value between 3 and 18 must be specified.
|
|
</li>
|
|
</ol>
|
|
<p>When network server created with <b>Server connection *ISCSI</b> and <b>Server operating system *WIN32</b>:
|
|
</p>
|
|
<ol>
|
|
<li>Only ACCESS(*UPDATE) is valid for DRVSEQNBR values 1 and 2.
|
|
</li>
|
|
<li>When ACCESS *UPDATE or *SHRUPD is specified, a value between 3 and 63 must be specified.
|
|
</li>
|
|
</ol>
|
|
<p>When network server created with <b>Server connection *IXSVR</b> or <b>*ISCSI</b> and <b>Server operating system *LINUX32</b>:
|
|
</p>
|
|
<ol>
|
|
<li>Only ACCESS(*UPDATE) is valid for DRVSEQNBR values 1 and 2.
|
|
</li>
|
|
<li>When ACCESS *UPDATE or *SHRUPD is specified, a value between 3 and 64 must be specified.
|
|
</li>
|
|
</ol>
|
|
<p>When network server created with <b>Server connection *GUEST</b>:
|
|
</p>
|
|
<ol>
|
|
<li>Any access mode can be specified for a value between 1 and 64.
|
|
</li>
|
|
</ol>
|
|
<p>
|
|
<b>Note: </b>If a non-sequential number is specified for a Network server description (NWSD) created with <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter, the number may not match the logical unit number on Windows or Linux and unexpected results may occur on drive assignments and applications.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNWSSTGL.STGPTHNBR"></a>
|
|
<h3>Storage path number (STGPTHNBR)</h3>
|
|
<p>Specifies the storage path number in the network server description (NWSD) that is used by this storage space.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid when <b>Server connection</b> specified *ISCSI for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<p>See <b>Storage path (STGPTH)</b> parameter of the network server description on the <b>CRTNWSD</b> or <b>CHGNWSD</b> commands.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFTSTGPTH</u></b></dt>
|
|
<dd>The storage space is linked to the relative storage path of the file server defined in the <b>Default storage path (DFTSTGPTH)</b> parameter of the network server description.
|
|
</dd>
|
|
<dt><b>*MLTPTHGRP</b></dt>
|
|
<dd>The storage space is linked using a multiple path group as defined on the <b>Multi-path group (MLTPTHGRP)</b> parameter of the network server description.
|
|
</dd>
|
|
<dt><b><i>1-4</i></b></dt>
|
|
<dd>The storage space is linked using a specific file server storage path number. Use the <b>DSPNWSD</b> command with OPTION(*STGPTH) to see which storage paths are valid.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNWSSTGL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1:Linking Storage Spaces to a Network Server</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNWSSTGL NWSSTG(PARTS) NWSD(WNTSVR) DRVSEQNBR(3)
|
|
ADDNWSSTGL NWSSTG(DATA) NWSD(WNTSVR) DRVSEQNBR(*CALC)
|
|
</pre>
|
|
</p>
|
|
<p>These commands link storage space PARTS to the Windows server at drive sequence 3, and storage space DATA at the next available sequence number.
|
|
</p>
|
|
<p><b>Example 2:Linking a Dynamic Storage Space</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNWSSTGL NWSSTG(DATAUPD) NWSD(W2KSVR) DYNAMIC(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command dynamically links the storage to the Windows server to the next available dynamic storage sequence.
|
|
</p>
|
|
<p><b>Example 3: Linking Quorum and Shared Storage Spaces</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNWSSTGL NWSSTG(QUORUM) NWSD(DNETSVR1) DYNAMIC(*YES)
|
|
ACCESS(*SHRUPD) DRVSEQNBR(*QR)
|
|
ADDNWSSTGL NWSSTG(QUORUM) NWSD(DNETSVR2) DYNAMIC(*YES)
|
|
ACCESS(*SHRUPD) DRVSEQNBR(*QR)
|
|
ADDNWSSTGL NWSSTG(DATASHR) NWSD(DNETSVR1) DYNAMIC(*YES)
|
|
ACCESS(*SHRUPD) DRVSEQNBR(*CALC)
|
|
ADDNWSSTGL NWSSTG(DATASHR) NWSD(DNETSVR2) DYNAMIC(*YES)
|
|
ACCESS(*SHRUPD) DRVSEQNBR(*CALC)
|
|
</pre>
|
|
</p>
|
|
<p>These commands allow two Windows servers DNETSVR1 and DNETSVR2 to share storage space DATASHR with read/write access.
|
|
</p>
|
|
<p><b>Example 4: Linking a Storage Path</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDNWSSTGL NWSSTG(DATAUPD) NWSD(W2KSVR)
|
|
STGPTHNBR(*DFTSTGPTH)
|
|
</pre>
|
|
</p>
|
|
<p>This command links the storage to the Windows server using the default storage path identified in the NWSD.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNWSSTGL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF26BA</b></dt>
|
|
<dd>Add network server storage link command failed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNWSSTGL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|