1857 lines
68 KiB
HTML
1857 lines
68 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 Network Server Desc (CHGNWSD)</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="CHGNWSD.Top_Of_Page"></a>
|
|
<h2>Change Network Server Desc (CHGNWSD)</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="#CHGNWSD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGNWSD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGNWSD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGNWSD"></a>
|
|
<p>The Change Network Server Description (CHGNWSD) command changes a network server description. Parameters that can be changed include server software parameters and network protocol descriptions.
|
|
</p>
|
|
<p>More information about using this command is in the Communications Configuration book, SC41-5401.
|
|
</p>
|
|
<p>More information about using network server descriptions where <b>Server connection</b> specified *IXSVR and <b>Server operating system</b> specified *WIN32 for the <b>Network server type (TYPE)</b> parameter in <b>CRTNWSD</b> command can be found in the Windows environment on iSeries information in iSeries Information Center at http://www.iseries.ibm.com/infocenter
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGNWSD.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="#CHGNWSD.NWSD"><b>NWSD</b></a></td>
|
|
<td valign="top">Network server description</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.RSRCNAME"><b>RSRCNAME</b></a></td>
|
|
<td valign="top">Resource name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE, *AUTO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#CHGNWSD.STGPTH"><b>STGPTH</b></a></td>
|
|
<td valign="top">Storage path</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 4 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Network server host adapter</td>
|
|
<td valign="top">
|
|
<i>Communications name</i>, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: IP security rules</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Remote interface 1 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Remote interface 2 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Remote interface 3 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 4: Remote interface 4 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.DFTSECRULE"><b>DFTSECRULE</b></a></td>
|
|
<td valign="top">Default IP security rule</td>
|
|
<td valign="top">1-16, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.MLTPTHGRP"><b>MLTPTHGRP</b></a></td>
|
|
<td valign="top">Multi-path group</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 4 repetitions): 1-4</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.DFTSTGPTH"><b>DFTSTGPTH</b></a></td>
|
|
<td valign="top">Default storage path</td>
|
|
<td valign="top">1-4, <b><u>*SAME</u></b>, *MLTPTHGRP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.RMVMEDPTH"><b>RMVMEDPTH</b></a></td>
|
|
<td valign="top">Removable media path</td>
|
|
<td valign="top">1-4, <b><u>*SAME</u></b>, *MLTPTHGRP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.ACTTMR"><b>ACTTMR</b></a></td>
|
|
<td valign="top">Activation timer</td>
|
|
<td valign="top">30-1800, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.ONLINE"><b>ONLINE</b></a></td>
|
|
<td valign="top">Online at IPL</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.VRYWAIT"><b>VRYWAIT</b></a></td>
|
|
<td valign="top">Vary on wait</td>
|
|
<td valign="top">1-15, <b><u>*SAME</u></b>, *NOWAIT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.SHUTDTIMO"><b>SHUTDTIMO</b></a></td>
|
|
<td valign="top">Shutdown timeout</td>
|
|
<td valign="top">2-45, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.PARTITION"><b>PARTITION</b></a></td>
|
|
<td valign="top">Partition</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.PTNNBR"><b>PTNNBR</b></a></td>
|
|
<td valign="top">Partition number</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.PRPDMNUSR"><b>PRPDMNUSR</b></a></td>
|
|
<td valign="top">Propagate domain users</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.CODEPAGE"><b>CODEPAGE</b></a></td>
|
|
<td valign="top">Code page</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *LNGVER</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGNWSD.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Server message queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *JOBLOG, *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Server message queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGNWSD.EVTLOG"><b>EVTLOG</b></a></td>
|
|
<td valign="top">Event log</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *ALL, *NONE<br>Other values (up to 3 repetitions): *SYS, *SEC, *APP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGNWSD.CMNMSGQ"><b>CMNMSGQ</b></a></td>
|
|
<td valign="top">Communications message queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSOPR<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Communications message queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGNWSD.CFGFILE"><b>CFGFILE</b></a></td>
|
|
<td valign="top">Configuration file</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Configuration file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="6"><a href="#CHGNWSD.TCPPORTCFG"><b>TCPPORTCFG</b></a></td>
|
|
<td valign="top">TCP/IP port configuration</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 9 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="6">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Port</td>
|
|
<td valign="top">
|
|
1, 2, 3, 4, *INTERNAL, *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Internet address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Subnet mask</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Maximum transmission unit</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, <b><u>1500</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: Gateway address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGNWSD.TCPRTE"><b>TCPRTE</b></a></td>
|
|
<td valign="top">TCP/IP route configuration</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 24 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Route destination</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, *DFTROUTE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Subnet mask</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, *NONE, *HOST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Next hop</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.TCPHOSTNAM"><b>TCPHOSTNAM</b></a></td>
|
|
<td valign="top">TCP/IP local host name</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NWSD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.TCPDMNNAME"><b>TCPDMNNAME</b></a></td>
|
|
<td valign="top">TCP/IP local domain name</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *SYS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.TCPNAMSVR"><b>TCPNAMSVR</b></a></td>
|
|
<td valign="top">TCP/IP name server system</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYS, *NONE<br>Other values (up to 3 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="8"><a href="#CHGNWSD.VRTETHPTH"><b>VRTETHPTH</b></a></td>
|
|
<td valign="top">Virtual Ethernet path</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="8">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Port number</td>
|
|
<td valign="top">
|
|
*VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Network server host adapter</td>
|
|
<td valign="top">
|
|
<i>Communications name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: IP security rules</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Remote interface 1 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Remote interface 2 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 3: Remote interface 3 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 4: Remote interface 4 rule</td>
|
|
<td valign="top">
|
|
1-16, *DFTSECRULE, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.RSTDDEVRSC"><b>RSTDDEVRSC</b></a></td>
|
|
<td valign="top">Restricted device resources</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *ALL<br>Other values (up to 10 repetitions): <i>Name</i>, *ALLTAPE, *ALLOPT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGNWSD.NWSCFG"><b>NWSCFG</b></a></td>
|
|
<td valign="top">Network server configuration</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Remote system name</td>
|
|
<td valign="top">
|
|
<i>Name</i>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Connection security name</td>
|
|
<td valign="top">
|
|
<i>Name</i>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.SHUTDPORT"><b>SHUTDPORT</b></a></td>
|
|
<td valign="top">Shutdown TCP port</td>
|
|
<td valign="top">1024-65535, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.VRTETHCTLP"><b>VRTETHCTLP</b></a></td>
|
|
<td valign="top">Virtual Ethernet control port</td>
|
|
<td valign="top">1024-65535, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.SYNCTIME"><b>SYNCTIME</b></a></td>
|
|
<td valign="top">Synchronize date and time</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *TYPE, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.IPLSRC"><b>IPLSRC</b></a></td>
|
|
<td valign="top">IPL source</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NWSSTG, *PANEL, *STMF, A, B, D</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.IPLSTMF"><b>IPLSTMF</b></a></td>
|
|
<td valign="top">IPL stream file</td>
|
|
<td valign="top"><i>Path name</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.IPLPARM"><b>IPLPARM</b></a></td>
|
|
<td valign="top">IPL parameters</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.PWRCTL"><b>PWRCTL</b></a></td>
|
|
<td valign="top">Power control</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNWSD.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGNWSD.NWSD"></a>
|
|
<h3>Network server description (NWSD)</h3>
|
|
<p>Specifies the network server description to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a network server description.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.RSRCNAME"></a>
|
|
<h3>Resource name (RSRCNAME)</h3>
|
|
<p>Specifies the resource name that identifies the hardware that the description represents.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. Specify the resource name of the input/output processor (IOP) or the input/output adapter (IOA) for the file server.
|
|
</li>
|
|
<li>This parameter can be changed only while the network server is varied off.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>A hardware resource is not associated with the network server. This value is only valid when <b>Server connection</b> specified *GUEST or *ISCSI for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command. *NONE is the only valid value when *ISCSI is specified for <b>Server connection</b> on the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</dd>
|
|
<dt><b>*AUTO</b></dt>
|
|
<dd>A hardware resource will be determined based on the partition. This value is only valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify a resource name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.STGPTH"></a>
|
|
<h3>Storage path (STGPTH)</h3>
|
|
<p>Specifies the storage paths the storage spaces can use. This information consists of two parts including the <b>Network server host adapter</b> description and the <b>IP security rules</b> for this path. You must enter at least one storage path. The first storage path in this parameter will be storage path one. You can enter up to four values for this parameter.
|
|
</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><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Network server host adapter</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify a name of network server host adapter (NWSH) description. The network server host adapter name must be unique for each <b>Storage path (STGPTH)</b> parameter on this NWSD.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>This storage path is not used by this network server.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: IP security rules</b>
|
|
</p>
|
|
<dl>
|
|
<p>Specify any relative entry of the IP security rule (IPSECRULE) parameter, defined in NWS Configuration (NWSCFG) of type *CNNSEC, that will be used for each remote interface's security.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Remote interface 1 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 1 will use IP security rule specified on the <b>Default IP security rule (DFTSECRULE)</b> parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 1 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 1 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Remote interface 2 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 2 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 2 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 2 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Remote interface 3 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 3 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 3 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 3 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Remote interface 4 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 4 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 4 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 4 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.DFTSECRULE"></a>
|
|
<h3>Default IP security rule (DFTSECRULE)</h3>
|
|
<p>Specify any defined entry of the <b>IP security rules (IPSECRULE)</b> parameter, defined in <b>Network server configuration (NWSCFG)</b> of type connection security (*CNNSEC), that will be used for storage and virtual Ethernet connections that are configured to use the default security rule.
|
|
</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>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interfaces will not use IP security rules.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interfaces will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.MLTPTHGRP"></a>
|
|
<h3>Multi-path group (MLTPTHGRP)</h3>
|
|
<p>Specify storage paths as defined in the <b>Storage path (STGPTH)</b> parameter.
|
|
</p>
|
|
<ol>
|
|
<li>See the <b>Storage path (STGPTH)</b> parameter to determine what storage paths are valid.
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ol>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No multi-path group defined.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 4 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-4</i></b></dt>
|
|
<dd>Specify at least two relative storage paths.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.DFTSTGPTH"></a>
|
|
<h3>Default storage path (DFTSTGPTH)</h3>
|
|
<p>Specify a storage path as defined in the <b>Storage path (STGPTH)</b> parameter or specify the multi-path group as defined in the <b>Multi-path group (MLTPTHGRP)</b> parameter.
|
|
</p>
|
|
<ol>
|
|
<li>See the <b>Storage path (STGPTH)</b> parameter to determine what storage paths are valid.
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>1-4</i></b></dt>
|
|
<dd>Default storage path will be storage path 1, 2, 3 or 4.
|
|
</dd>
|
|
<dt><b>*MLTPTHGRP</b></dt>
|
|
<dd>Default storage path will be the multi-path group storage path.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.RMVMEDPTH"></a>
|
|
<h3>Removable media path (RMVMEDPTH)</h3>
|
|
<p>Specify a storage path as defined in the <b>Storage path (STGPTH)</b> parameter or specify the multi-path group as defined in the <b>Multi-path group (MLTPTHGRP)</b> parameter.
|
|
</p>
|
|
<ol>
|
|
<li>See the <b>Storage path (STGPTH)</b> parameter to determine what storage paths are valid.
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>1-4</i></b></dt>
|
|
<dd>Removable media will use storage path 1, 2, 3 or 4.
|
|
</dd>
|
|
<dt><b>*MLTPTHGRP</b></dt>
|
|
<dd>Removable media will use the multi-path group storage path.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.ACTTMR"></a>
|
|
<h3>Activation timer (ACTTMR)</h3>
|
|
<p>Specifies the amount of time (in seconds) the system will wait for the connection to be established to the remote server's service processor and to power on the remote server.
|
|
</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>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>activation-timer</i></b></dt>
|
|
<dd>Specify, in seconds, a value ranging from 30 through 1800.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.ONLINE"></a>
|
|
<h3>Online at IPL (ONLINE)</h3>
|
|
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This parameter is ignored when <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter. To have the Windows server vary on, use the CHGTCPIFC command and set the AUTOSTART parameter to *YES for the private LAN line description for the server or a startup program could be called to vary on the servers after IPL processing has completed.
|
|
</li>
|
|
<li>When <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command, it is recommended that *NO is configured. A startup program should then be called to vary on the servers after IPL processing has completed.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The server is automatically varied on at IPL.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>This server is not automatically varied on at IPL.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.VRYWAIT"></a>
|
|
<h3>Vary on wait (VRYWAIT)</h3>
|
|
<p>Specifies whether the network server description is varied on asynchronously or synchronously. For synchronous vary on, specifies how long the system waits for the vary on to complete.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Vary on of a network server resets the IOP.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NOWAIT</b></dt>
|
|
<dd>The system does not wait for the vary on to complete. The network server description is varied on asynchronously.
|
|
</dd>
|
|
<dt><b><i>vary-on-wait</i></b></dt>
|
|
<dd>Specify the time (in minutes) to wait. Valid values range from 1 through 15. The system waits until the network server description is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.SHUTDTIMO"></a>
|
|
<h3>Shutdown timeout (SHUTDTIMO)</h3>
|
|
<p>Specifies the network server shutdown timeout value in minutes. This is used to limit the amount of time that the network servers operating system is allowed to shutdown before the network server is varied offline.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>2-45</i></b></dt>
|
|
<dd>Specify the number of minutes to wait. The system waits until the network servers operating system has shutdown successfully, or until the specified time passes before varying the network server offline.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.PARTITION"></a>
|
|
<h3>Partition (PARTITION)</h3>
|
|
<p>Specifies the name of the logical partition to be used by this network server. Up to 48 characters may be specified.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>When <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter either the <b>Partition (PARTITION)</b> or <b>Partition number (PTNNBR)</b> parameter can be specified but both parameters cannot be specified. When <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter and RSRCNAME is specified, the <b>Partition (PARTITION)</b> and <b>Partition number (PTNNBR)</b> parameter can be set to *NONE.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>*NONE</i></b></dt>
|
|
<dd>A partition name is not used by this network server.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the partition to be used by this network server. The partition name PRIMARY cannot be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.PTNNBR"></a>
|
|
<h3>Partition number (PTNNBR)</h3>
|
|
<p>Specifies the number of the logical partition to be used by this network server.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>When <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter either the <b>Partition (PARTITION)</b> or <b>Partition number (PTNNBR)</b> parameter can be specified but both parameters cannot be specified.
|
|
</li>
|
|
<li>When <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter and RSRCNAME is specified, the <b>Partition (PARTITION)</b> and <b>Partition number (PTNNBR)</b> parameter can be set to *NONE.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>*NONE</i></b></dt>
|
|
<dd>A partition number is not used by this network server.
|
|
</dd>
|
|
<dt><b><i>number</i></b></dt>
|
|
<dd>Specify the number of the partition to be used by this network server.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.PRPDMNUSR"></a>
|
|
<h3>Propagate domain users (PRPDMNUSR)</h3>
|
|
<p>Allows users to determine if domain user enrollment should be allowed or not on a particular NWSD.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored when <b>Server connection</b> specified *GUEST or <b>Server operating system</b> specified *LINUX32 for <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>*YES</i></b></dt>
|
|
<dd>Propagation of domain user enrollment is allowed for this NWSD.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Propagation of domain user enrollment is not allowed for this NWSD.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.CODEPAGE"></a>
|
|
<h3>Code page (CODEPAGE)</h3>
|
|
<p>Specifies the ASCII code page representing the character set to be used by this network server. Only certain code pages can be used for a given country or region code.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This parameter can be changed only while the network server is varied off.
|
|
</li>
|
|
<li>This parameter is ignored when <b>Server connection</b> specified *GUEST or <b>Server operating system</b> specified *LINUX32 for <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LNGVER</b></dt>
|
|
<dd>Specifies to use the default code page corresponding to the language version (LNGVER) selected.
|
|
</dd>
|
|
<dt><b><i>integer-number</i></b></dt>
|
|
<dd>Specify the ASCII code page which represents the character set used by the network server. The code pages that can be used with each country or region code are:
|
|
<dl>
|
|
<dt><b>437</b></dt>
|
|
<dd>United States
|
|
</dd>
|
|
<dt><b>850</b></dt>
|
|
<dd>Multilingual
|
|
</dd>
|
|
<dt><b>852</b></dt>
|
|
<dd>Latin 2 (Czechoslovakia, Hungary, Poland, countries of the former Yugoslavia)
|
|
</dd>
|
|
<dt><b>857</b></dt>
|
|
<dd>Turkish
|
|
</dd>
|
|
<dt><b>860</b></dt>
|
|
<dd>Portuguese
|
|
</dd>
|
|
<dt><b>861</b></dt>
|
|
<dd>Iceland
|
|
</dd>
|
|
<dt><b>862</b></dt>
|
|
<dd>Hebrew-speaking
|
|
</dd>
|
|
<dt><b>863</b></dt>
|
|
<dd>Canada (French-speaking)
|
|
</dd>
|
|
<dt><b>864</b></dt>
|
|
<dd>Arabic-speaking
|
|
</dd>
|
|
<dt><b>865</b></dt>
|
|
<dd>Nordic
|
|
</dd>
|
|
<dt><b>866</b></dt>
|
|
<dd>Russian
|
|
</dd>
|
|
<dt><b>932</b></dt>
|
|
<dd>Japanese
|
|
</dd>
|
|
<dt><b>934</b></dt>
|
|
<dd>Korean
|
|
</dd>
|
|
<dt><b>938</b></dt>
|
|
<dd>Chinese
|
|
</dd>
|
|
<dt><b>942</b></dt>
|
|
<dd>Japanese SAA
|
|
</dd>
|
|
<dt><b>944</b></dt>
|
|
<dd>Korean SAA
|
|
</dd>
|
|
<dt><b>948</b></dt>
|
|
<dd>Chinese SAA
|
|
</dd>
|
|
<dt><b>950</b></dt>
|
|
<dd>Traditional Chinese (DBCS)
|
|
</dd>
|
|
<dt><b>1381</b></dt>
|
|
<dd>Simplified Chinese (DBCS)
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.MSGQ"></a>
|
|
<h3>Server message queue (MSGQ)</h3>
|
|
<p>Specifies the message queue to receive server messages.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>For details on the type of messages that are sent to this message queue, see the appropriate manual that is associated with the type of network server.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*JOBLOG</b></dt>
|
|
<dd>Console messages are placed on the joblog of the current job.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Console messages are not placed in a message queue.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Server message queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message queue to receive the server console messages.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.EVTLOG"></a>
|
|
<h3>Event log (EVTLOG)</h3>
|
|
<p>Specifies whether or not messages from the event log are received from the server.
|
|
</p>
|
|
<p>Event log messages are placed in the message queue that is specified for the <b>Server message queue (MSGQ)</b> parameter. The MSGQ value cannot be *NONE if a value other than *NONE is specified for the EVTLOG parameter. See the MSGQ parameter for more information.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is not valid when <b>Server connection</b> specified *GUEST or <b>Server operating system</b> specified *LINUX32 for <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All the event log messages are received.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The event log messages are not received.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SYS</b></dt>
|
|
<dd>The system event log messages are received.
|
|
</dd>
|
|
<dt><b>*SEC</b></dt>
|
|
<dd>The security event log messages are received.
|
|
</dd>
|
|
<dt><b>*APP</b></dt>
|
|
<dd>The application event log messages are received.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.CMNMSGQ"></a>
|
|
<h3>Communications message queue (CMNMSGQ)</h3>
|
|
<p>Specifies the name of a message queue to receive communications status messages. This parameter is only valid for server connection type *ISCSI.
|
|
</p>
|
|
<p>For details on the type of messages that are sent to this message queue, see the appropriate manual that is associated with the type of network server.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*SYSOPR</b></dt>
|
|
<dd>Causes messages from the server to be placed in the system operator message queue.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Communications message queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a message queue to receive status messages issued by the server.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.CFGFILE"></a>
|
|
<h3>Configuration file (CFGFILE)</h3>
|
|
<p>Specifies the source file containing configuration data to be used in activating or further defining the server.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is not valid when <b>Server connection</b> specified *GUEST for <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No configuration file is specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Configuration file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the source file containing the configuration data. The file must exist on the system by the time the server is activated.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TCPPORTCFG"></a>
|
|
<h3>TCP/IP port configuration (TCPPORTCFG)</h3>
|
|
<p>Specifies the TCP/IP configuration values that are specific to a port on the network server. This information consists of four parts including the identification of the network server port, the internet address assigned to the port, and the subnet mask of the port. When <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter you can enter up to three values for this parameter, one for each port that can exist on a network server.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no TCP/IP port configuration. *NONE cannot be specified when <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 9 repetitions)</b>
|
|
</p>
|
|
<p><b>Element 1: Port</b>
|
|
</p>
|
|
<p>Specifies the network server port number to be configured.
|
|
</p>
|
|
<dl>
|
|
<dt><b>1</b></dt>
|
|
<dd>Network server port number 1 is configured.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>Network server port number 2 is configured.
|
|
</dd>
|
|
<dt><b>3</b></dt>
|
|
<dd>Network server port number 3 is configured.
|
|
</dd>
|
|
<dt><b>4</b></dt>
|
|
<dd>Network server port number 4 is configured.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>The following values are not valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*INTERNAL </b></dt>
|
|
<dd>The network server internal token ring port is configured.
|
|
<p>
|
|
<b>Note: </b>*INTERNAL is not 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>
|
|
</dd>
|
|
<dt><b>*VRTETHPTP</b></dt>
|
|
<dd>The network server virtual Ethernet point to point port is configured.
|
|
</dd>
|
|
<dt><b>*VRTETHn</b></dt>
|
|
<dd>Virtual Ethernet port <b>'n'</b> is configured, where <b>'n'</b> is a number from 1 to 9.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Internet address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the local internet address which the network server responds to when <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter. 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 binary zeros for the network identifier (ID) portion or the host ID portion of the Internet address is not valid. The internet address selected must be unique across all NWSD objects and the i5/OS TCP/IP configuration.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Subnet mask</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the subnet mask associated with the network server port. See the <i>TCP/IP Fastpath Setup</i> book for general information about subnets.
|
|
<p>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. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For example, a subnet mask of 255.255.255.0 defines a Class B subnet consisting of all bits in the network portion of the internet address (this is a given) and consisting of all bits in the third byte of an internet address.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Maximum transmission unit</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1500</u></b></dt>
|
|
<dd>The maximum transmission unit (MTU) value is 1500 bytes.
|
|
</dd>
|
|
<dt><b><i>integer-number</i></b></dt>
|
|
<dd>Specifies the MTU value, in bytes, for the interface.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 5: Gateway address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the default gateway address for the internet address in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TCPRTE"></a>
|
|
<h3>TCP/IP route configuration (TCPRTE)</h3>
|
|
<p>Specifies routes to remote destination systems or networks to the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration for the network server. A route specification has three elements, the route destination, the subnet mask, and the next hop internet address. A maximum of 24 route specifications can be specified.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter will be ignored when <b>Server connection</b> specified *IXSVR or *ISCSI for the <b>Network server type (TYPE)</b> parameter.
|
|
</p>
|
|
<p>Two values uniquely define a route. They are the route destination field and the subnet mask. For *DFTROUTE values, the next hop element uniquely defines the route.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no routing specification needed for the network server. *NONE must be specified when TCPPORTCFG(*NONE) is specified. *NONE may be specified if there is no need for route specifications.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Route destination</b>
|
|
</p>
|
|
<p>Specifies the remote network or host that is being added. The user must specify all four bytes that make up an internet address though some of the bytes may be equal to 0. For example, a route to all the hosts on the 9.5.11 subnet is identified by entering 9.5.11.0 for the route destination. Used in combination with a subnet mask, the route destination will identify a route to a network or system.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTROUTE</b></dt>
|
|
<dd>A TCP/IP default route is being added. A default route entry is used by the system to route data that is being sent to an undefined network or system. Multiple *DFTROUTE entries may be specified. The *DFTROUTE entries are used in the order specified. If a particular next hop gateway on a *DFTROUTE entry is not available, then the subsequent *DFTROUTE entry's next hop gateway specified will be used. This will continue until a *DFTROUTE entry's gateway is found that is active or the list of next hop gateway values is exhausted.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the route destination being added. The route destination can be specified in the form, <i>nnn.0.0.0</i> for Class A, <i>nnn.nnn.0.0</i> for Class B, and <i>nnn.nnn.nnn.0</i> for Class C, or <i>nnn.nnn.nnn.nnn</i> for any combination thereof, where <i>nnn</i> is a decimal number ranging from 0 through 255.
|
|
<p>
|
|
<b>Note: </b>Any combination thereof means that you may specify a route, such as 9.5.0.0 to the hosts on the 9.5 subnet even though all 9.5.x.x addresses are class A network addresses.
|
|
</p>
|
|
<p>Exceptions:
|
|
</p>
|
|
<ul>
|
|
<li>The first byte (octet) must be greater than 0 and less than 255
|
|
</li>
|
|
<li>The last byte (octet) may not equal 255.
|
|
</li>
|
|
<li>The last byte (octet) may not equal 0 if *HOST is specified for the SUBNETMASK value.
|
|
</li>
|
|
<li>Routes to a broadcast address are not allowed.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Subnet mask</b>
|
|
</p>
|
|
<p>A subnet mask value must be specified if *DFTROUTE or a route destination is entered for the route destination element. Subnet mask specifies a bit mask that identifies to TCP/IP which bits of the value specified for the route destination compose the network and subnet portions of the internet address. The subnet is identified by combining the route destination internet address and the subnet mask.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no subnet mask. If *DFTROUTE is specified in the route destination element, then *NONE must be specified. *NONE is valid only for the *DFTROUTE route destination value.
|
|
</dd>
|
|
<dt><b>*HOST</b></dt>
|
|
<dd>The internet address value specified in the route destination field is a host address. The subnetmask value is calculated to be 255.255.255.255.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the mask of the subnet field. The internet address is in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. For example, a destination route's internet address value of 129.35.11.0 is a Class B subnet. The network ID part of its address is 129.35. The upper 2 bytes must designate 255 in the subnet mask, for example, the subnet mask must appear like 255.255.x.x, where x is determined by the user. The portion of the subnet mask which is associated with the network portion of a particular class of address must equal 255.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Next hop</b>
|
|
</p>
|
|
<p>The next hop value specifies the internet address of the next system (gateway) on the route. A route cannot be added unless the internet address specified by the next hop element is directly reachable through a network associated with one of the network server ports.
|
|
</p>
|
|
<p>See the <i>Fastpath for TCP/IP</i> book for general information about internet addresses.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the internet address of the next system on the route in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255 except that the host ID portion and the network ID portion of the internet address may not be all 0 bits or all 1 bits. An internet address that has all binary ones or all binary zeros for the network ID portion or the host ID portion of the internet address is not valid.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TCPHOSTNAM"></a>
|
|
<h3>TCP/IP local host name (TCPHOSTNAM)</h3>
|
|
<p>Specifies the short form of the host name to be associated with the network server.
|
|
</p>
|
|
<p>The host name can be a text string having 2 through 63 characters.
|
|
</p>
|
|
<p>The following characters are allowed in host names:
|
|
</p>
|
|
<ul>
|
|
<li>Alphabetical characters A through Z
|
|
</li>
|
|
<li>Digits 0 through 9
|
|
</li>
|
|
<li>Minus sign (-)
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NWSD</b></dt>
|
|
<dd>Specifies that the host name for the network server is the same as the name of the network server decsription. *NWSD must be specified if *NONE is specified for the <b>TCP/IP port configuration (TCPPORTCFG)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify a host name to be associated with the network server.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TCPDMNNAME"></a>
|
|
<h3>TCP/IP local domain name (TCPDMNNAME)</h3>
|
|
<p>Specifies the local domain name associated with the network server.
|
|
</p>
|
|
<p>A domain name can be a text string having 2 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The following characters are allowed in domain names:
|
|
</p>
|
|
<ul>
|
|
<li>Alphabetical characters A through Z
|
|
</li>
|
|
<li>Digits 0 through 9
|
|
</li>
|
|
<li>Minus sign (-)
|
|
</li>
|
|
<li>Period (.). Periods are only allowed when they separate labels of domain style name.
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
<b>Note: </b>These characters are all invariant characters.
|
|
</p>
|
|
<p>Other domain name conventions include the following:
|
|
</p>
|
|
<ul>
|
|
<li>Uppercase and lowercase characters are allowed, but no significance attached to the case. The case is maintained as entered. The first and last character of the host name must be an alphabetic character or a digit.
|
|
</li>
|
|
<li>Try to limit your domain name labels to 12 characters because shorter labels are easier to remember.
|
|
</li>
|
|
<li>It is a common practice to use hierarchical names that allow predictable extensions for change and growth. Domain names normal reflect the delegation of authority or hierarchy used to assign them.
|
|
</li>
|
|
</ul>
|
|
<p>For example, the name SYS1.MFG.ABC.COM can be broken down into the following:
|
|
</p>
|
|
<dl>
|
|
<dt><b>COM</b></dt>
|
|
<dd>All commercial networks.
|
|
</dd>
|
|
<dt><b>ABC.COM</b></dt>
|
|
<dd>All systems in the ABC company's commercial network.
|
|
</dd>
|
|
<dt><b>MFG.ABC.COM</b></dt>
|
|
<dd>All manufacturing systems in the ABC company's commercial network.
|
|
</dd>
|
|
<dt><b>SYS1.MFG.ABC.COM</b></dt>
|
|
<dd>A host named SYS1 in the manufacturing area of the company's commercial network.
|
|
</dd>
|
|
</dl>
|
|
<p>In the above example, MFG.ABC.COM is the domain name and SYS1 is the short form of the host name.
|
|
</p>
|
|
<p>The COM designation is one of several domain names used when connecting the Internet. Some of the other domain names are as follows:
|
|
</p>
|
|
<dl>
|
|
<dt><b>COM</b></dt>
|
|
<dd>Commercial organizations
|
|
</dd>
|
|
<dt><b>EDU</b></dt>
|
|
<dd>Educational institutions
|
|
</dd>
|
|
<dt><b>GOV</b></dt>
|
|
<dd>Government institutions
|
|
</dd>
|
|
<dt><b>MIL</b></dt>
|
|
<dd>Military groups
|
|
</dd>
|
|
<dt><b>NET</b></dt>
|
|
<dd>Major network support centers
|
|
</dd>
|
|
<dt><b>ORG</b></dt>
|
|
<dd>Organizations other than those listed above
|
|
</dd>
|
|
<dt><b>Country code</b></dt>
|
|
<dd>Countries or regions other than USA
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*SYS</b></dt>
|
|
<dd>Specifies that the local domain name for the network server should be the same value as is configured for the iSeries. *SYS must be specified if TCPPORTCFG(*NONE) is specified. Also, *SYS must be specified if only an *INTERNAL port is specified on the TCPPORTCFG parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify a host name to be associated with the network server.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TCPNAMSVR"></a>
|
|
<h3>TCP/IP name server system (TCPNAMSVR)</h3>
|
|
<p>Specifies the internet address of the name server system that is used by the network server. Typically, this is the same value as it is for the iSeries system.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*SYS</b></dt>
|
|
<dd>The name server system used by the network server should be the same as for the iSeries. *SYS must be specified if TCPPORTCFG(*NONE) is specified.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no name server to be used by the network server.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify an internet address for the name server system to be used by the network server. Up to three remote name server systems can be specified. The name server systems are used in the order they are specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.VRTETHPTH"></a>
|
|
<h3>Virtual Ethernet path (VRTETHPTH)</h3>
|
|
<p>Specifies the virtual Ethernet paths the Ethernet line descriptions can use. This information consists of three parts including the virtual Ethernet port, the <b>Network server host adapter</b> description and the <b>IP security rules</b> for this path. You can enter up to five values for this parameter. You must enter at least one virtual Ethernet path which is the path to be used by the *VRTETHPTP line description.
|
|
</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><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Port number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*VRTETHPTP</b></dt>
|
|
<dd>The network server virtual Ethernet point to point port is configured.
|
|
</dd>
|
|
<dt><b>*VRTETHn</b></dt>
|
|
<dd>Virtual Ethernet port <b>'n'</b> is configured, where <b>'n'</b> is a number from 1 to 9.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Network server host adapter</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an existing network server host adapter (NWSH) description. The network server host adapter name does not need to be unique for each VRTETHPTH parameter on this NWSD.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: IP security rules</b>
|
|
</p>
|
|
<p>Specify any relative entry of the IP security rule (IPSECRULE) parameter, defined in NWS Configuration (NWSCFG) of type *CNNSEC, that will be used for each remote port's security.
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Remote interface 1 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 1 will use IP security rule specified on the <b>Default IP security rule (DFTSECRULE)</b> parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 1 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 1 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Remote interface 2 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 2 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 2 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 2 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Remote interface 3 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 3 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 3 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 3 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Remote interface 4 rule</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFTSECRULE</b></dt>
|
|
<dd>Remote interface 4 will use IP security rule specified on the DFTSECRULE parameter.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Remote interface 4 will not use IP security rule.
|
|
</dd>
|
|
<dt><b><i>1-16</i></b></dt>
|
|
<dd>Remote interface 4 will use IP security rule specified.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.RSTDDEVRSC"></a>
|
|
<h3>Restricted device resources (RSTDDEVRSC)</h3>
|
|
<p>Specifies the iSeries device resource names that are restricted and cannot be used by network servers.
|
|
</p>
|
|
<p>The resource is used when the network server is active and a request is issued from the client that is running an application. The device resource cannot be used by the application and i5/OS at the same time. If the device resource is in used by the i5/OS, the application will not use this resource. If the device resource is intended to be used by the application, it will need to be available when the application is ready to use it.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>Only tape and optical device resources can be restricted.
|
|
</li>
|
|
<li>If other device resources are specified that are not valid or are not detected, they will not allow the network server to vary on.
|
|
</li>
|
|
<li>This parameter can be changed only while the network server is varied off.
|
|
</li>
|
|
</ol>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No device resources are restricted from the network server. Therefore, any tape or optical device resources that exist on the system can be used.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All tape and optical resources are restricted from being used by the network server.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 10 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLOPT</b></dt>
|
|
<dd>All optical resources are restricted from being used by the network server.
|
|
<p>
|
|
<b>Note: </b>This value can only be specified once.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*ALLTAPE</b></dt>
|
|
<dd>All tape resources are restricted from being used by the network server.
|
|
<p>
|
|
<b>Note: </b>This value can only be specified once.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the resource name of a restricted device that cannot be used by the network server. Up to 10 restricted device resource names can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.NWSCFG"></a>
|
|
<h3>Network server configuration (NWSCFG)</h3>
|
|
<p>Specifies the network server configuration descriptions to use with this NWSD. This information consists of two parts including the <b> Remote system name</b> and <b> Connection security name</b>
|
|
</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><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Remote system name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>Use the system generated default remote system network server configuration name of 'nwsdnameRM' where nwsdname is the name of this network server description.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an existing remote system network server configuration description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Connection security name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>Use the system generated default connection security network server configuration name of 'nwsdnameCN' where nwsdname is the name of this network server description.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an existing connection security network server configuration description.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.SHUTDPORT"></a>
|
|
<h3>Shutdown TCP port (SHUTDPORT)</h3>
|
|
<p>Specifies the TCP port to use for shutdown.
|
|
</p>
|
|
<p>This port listens through the local area network (LAN) interface configured for any network server host adapter (NWSH) device associated with the network server description (NWSD) object on the <b>Virtual Ethernet path (VRTETHPTH)</b> parameter.
|
|
</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>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specifies the port number identifying the port that is to be used for shutdown. Valid values range from 1024 through 65,535. Default value is 8700.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.VRTETHCTLP"></a>
|
|
<h3>Virtual Ethernet control port (VRTETHCTLP)</h3>
|
|
<p>Specifies the TCP port to use for virtual Ethernet control.
|
|
</p>
|
|
<p>This port listens through the local area network (LAN) interface configured for any network server host adapter (NWSH) device associated with the network server description (NWSD) object on the <b>Virtual Ethernet path (VRTETHPTH)</b> parameter.
|
|
</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>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specifies the port number identifying the port that is to be used for virtual Ethernet control. Valid values range from 1024 through 65,535. Default value is 8800.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.SYNCTIME"></a>
|
|
<h3>Synchronize date and time (SYNCTIME)</h3>
|
|
<p>Specifies whether the iSeries should synchronize the network server date and time with the iSeries system date and time.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is not valid when <b>Server operating system</b> specified *LINUX32 for <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*TYPE</b></dt>
|
|
<dd>The system will perform synchronization based on the network server type. When <b>Server operating system</b> specified *WIN32 for the <b>Network server type (TYPE)</b> parameter ,synchronization will be done as if SYNCTIME(*YES) was specified.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The system will synchronize the network server date and time with the iSeries system date and time.
|
|
<p>The following occurs when <b>Server operating system</b> specified *WIN32 for the <b>Network server type (TYPE)</b> parameter:
|
|
</p>
|
|
<ul>
|
|
<li>If the network server description is varied on, this reset will occur immediately and at least every 30 minutes thereafter.
|
|
</li>
|
|
<li>If the network server description is varied off, this reset will occur when the network server description is varied on and at least every 30 minutes thereafter.
|
|
</li>
|
|
</ul>
|
|
<p>The QTIMZON system value must be set to the correct value for time synchronization to work correctly.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The iSeries synchronizes the network server date and time with the iSeries system date and time when the network server description is varied on, but will not keep the date and time synchronized while the network server description is varied on. If the network server description is varied on when this parameter is set to this value, the date and time will no longer be synchronized while the network server description is varied on.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.IPLSRC"></a>
|
|
<h3>IPL source (IPLSRC)</h3>
|
|
<p>Specifies the source of the load image that the partition is started from.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NWSSTG</b></dt>
|
|
<dd>The partition is started using the load image in the first network server storage space attached to this network server description.
|
|
</dd>
|
|
<dt><b>*STMF</b></dt>
|
|
<dd>The partition is started using the load image in the stream file specified by the IPL stream file (IPLSTMF) parameter.
|
|
</dd>
|
|
<dt><b>*PANEL</b></dt>
|
|
<dd>The partition is started from the source indicated on the operator's panel.
|
|
</dd>
|
|
<dt><b>A</b></dt>
|
|
<dd>The partition is started from the A-source.
|
|
</dd>
|
|
<dt><b>B</b></dt>
|
|
<dd>The partition is started from the B-source.
|
|
</dd>
|
|
<dt><b>D</b></dt>
|
|
<dd>The partition is started from the D-source.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.IPLSTMF"></a>
|
|
<h3>IPL stream file (IPLSTMF)</h3>
|
|
<p>Specifies the path of the stream file containing the image that the partition should be loaded from.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command, and *STMF is specified for the <b>IPL source (IPLSRC)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>A stream file is not specified.
|
|
</dd>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the path of the stream file containing the load image. Up to 5000 characters may be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.IPLPARM"></a>
|
|
<h3>IPL parameters (IPLPARM)</h3>
|
|
<p>Specifies a string of characters that will be passed to the load image at IPL time. It consists of commands or configuration information for the guest operating system.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>IPL parameters are not passed to the load image.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify a string of up to 256 characters containing the IPL parameters to be passed to the load image.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.PWRCTL"></a>
|
|
<h3>Power control (PWRCTL)</h3>
|
|
<p>Specifies whether the partition associated with the network server description will be powered down when the network server description is varied offline or powered up when the network server description is varied online.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only valid when <b>Server connection</b> specified *GUEST for the <b>Network server type (TYPE)</b> parameter in the corresponding <b>CRTNWSD</b> command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The partition associated with the network server description will be powered down when the network server description is varied offline or powered up when the network server description is varied online.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The partition associated with the network server description will not be powered down when the network server description is varied offline and the partition will not be powered up when the network server description is varied online.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNWSD.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies text that briefly describes the network server description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>Text is not specified.
|
|
</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="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGNWSD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the TCP/IP Route Configuration</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGNWSD NWSD(REMODEL2) TCPRTE((*DFTROUTE *NONE '9.5.5.1'))
|
|
</pre>
|
|
</p>
|
|
<p>This command changes a server description named REMODEL2. The TCP/IP default route next hop address is changed to 9.5.5.1.
|
|
</p>
|
|
<p><b>Example 2: Changing the Restricted Device Resources</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGNWSD NWSD(WNTSVR4) RSTDDEVRSC(OPT02 *ALLTAPE)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes a server description named WNTSVR4. Device resource OPT02 and all tape resources (*ALLTAPE) are changed to have their access restricted from the network server.
|
|
</p>
|
|
<p><b>Example 3: Changing the Storage Path, Multi-path Group, Network Server Configuration and Shutdown TCP Port</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGNWSD NWSD(WINISCSI) STGPTH((NWSH3) (NWSH4 (5 3 8 9)))
|
|
MLTPTHGRP(1 2)
|
|
NWSCFG(YOURREMOTE YOURSECURITY)
|
|
SHUTDPORT(8950)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes a network server description named WINISCSI. Storage paths one and two are changed to use network server host adapters NWSH3 and NWSH4 and associated IP security rules. Multi-path group was changed to use storage paths 1 and 2. Network server configuration was changed to use YOURREMOTE for Remote system name and YOURSECURITY for Connection security name, and Shutdown TCP port was changed to 8950.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGNWSD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF26AD</b></dt>
|
|
<dd>Network server description &1 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNWSD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|