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

517 lines
20 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change NWS Attributes (CHGNWSA)</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="CHGNWSA.Top_Of_Page"></a>
<h2>Change NWS Attributes (CHGNWSA)</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="#CHGNWSA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGNWSA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGNWSA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGNWSA"></a>
<p>The Change Network Server Attributes (CHGNWSA) command changes the network server attributes of the system. Many of these attributes can be set on an individual user profile basis using the CHGNWSUSRA command. Many network server commands such as DSPNWSUSR and WRKNWSSTS can specify that information from the network server attributes should be used by specifying *NWSA for a given parameter.
</p>
<p>Network server attributes are saved by the Save System (SAVSYS) command. Network server attributes are restored to the system when the operating system is installed.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is shipped with public *EXCLUDE authority. When this command is shipped, authority is issued only to the security officer. The security officer can grant the use of this command to other users.
</li>
<li>To make changes to the NDSTREELST, WNTDMNLST, WNTLCLSVRL, or NTWTCPSVRL parameters, you must have *SECADM special authority.
</li>
<li>The Windows domain and server names specified in the WNTDMNLST and WNTLCLSVRL parameters must follow the naming conventions of Windows.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGNWSA.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="#CHGNWSA.PMTCTL"><b>PMTCTL</b></a></td>
<td valign="top">Prompt control</td>
<td valign="top"><b><u>*ALL</u></b>, *WINDOWS, *NETWARE, *WINDOWSNT</td>
<td valign="top">Optional, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWSA.DFTSVRTYPE"><b>DFTSVRTYPE</b></a></td>
<td valign="top">Default server type</td>
<td valign="top"><b><u>*SAME</u></b>, *WINDOWS, *NETWARE, *WINDOWSNT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWSA.NDSTREE"><b>NDSTREE</b></a></td>
<td valign="top">NDS tree</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="#CHGNWSA.NDSCTX"><b>NDSCTX</b></a></td>
<td valign="top">NDS context</td>
<td valign="top"><i>Path name</i>, <b><u>*SAME</u></b>, *ROOT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWSA.NTWTCPPORT"><b>NTWTCPPORT</b></a></td>
<td valign="top">NetWare TCP/IP port</td>
<td valign="top">50-50000, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNWSA.NTWTCPSVRL"><b>NTWTCPSVRL</b></a></td>
<td valign="top">NetWare/IP server list</td>
<td valign="top">Values (up to 100 repetitions): <i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CHGNWSA.NDSTREELST"><b>NDSTREELST</b></a></td>
<td valign="top">NDS tree list</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: NDS tree</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: User object context</td>
<td valign="top">
<i>Path name</i></td>
</tr>
<tr>
<td valign="top">Element 3: Default server</td>
<td valign="top">
<i>Character value</i>, <b><u>*ANY</u></b></td>
</tr>
<tr>
<td valign="top">Element 4: Profile object</td>
<td valign="top">
<i>Path name</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGNWSA.WNTDMNLST"><b>WNTDMNLST</b></a></td>
<td valign="top">Windows server domain list</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 64 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Domain</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: User template</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Group type</td>
<td valign="top">
<b><u>*GLOBAL</u></b>, *LOCAL</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGNWSA.WNTLCLSVRL"><b>WNTLCLSVRL</b></a></td>
<td valign="top">Windows local server list</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 64 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Server</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: User template</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGNWSA.PMTCTL"></a>
<h3>Prompt control (PMTCTL)</h3>
<p>Specifies which network server attributes should be prompted for on the command.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All parameters are prompted.
</dd>
<dt><b>*WINDOWS or *WINDOWSNT</b></dt>
<dd>Only those parameters that apply to Windows servers are prompted.
<p>
<b>Note: </b>*WINDOWS should be used in V5R4 and later releases. The *WINDOWSNT value is supported for compatibility with releases prior to V5R4.
</p>
</dd>
<dt><b>*NETWARE</b></dt>
<dd>Only those parameters that apply to *NETWARE servers are prompted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.DFTSVRTYPE"></a>
<h3>Default server type (DFTSVRTYPE)</h3>
<p>Specifies the default server type for the system. This attribute is used primarily as a default for those i5/OS commands that support multiple network types.
</p>
<p>If the default server type is not set, it is defaulted to *WINDOWS.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default server type does not change.
</dd>
<dt><b>*WINDOWS or *WINDOWSNT</b></dt>
<dd>The default server type for the system is set to *WINDOWS.
<p>
<b>Note: </b>*WINDOWS should be used in V5R4 and later releases. The *WINDOWSNT value is supported for compatibility with releases prior to V5R4.
</p>
</dd>
<dt><b>*NETWARE</b></dt>
<dd>The default server type for the system is set to *NETWARE.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.NDSTREE"></a>
<h3>NDS tree (NDSTREE)</h3>
<p>Specifies the name of the default NetWare Directory Services tree used by the system. The tree specified should be the one most often used by iSeries system users when accessing the network.
</p>
<p>If the default NetWare Directory Services tree is not set, it is defaulted to *NONE.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The NetWare Directory Services tree name does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No default NetWare Directory Services tree is specified.
</dd>
<dt><b><i>'NDS-tree-name'</i></b></dt>
<dd>Specify the name of the default NetWare Directory Services tree.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.NDSCTX"></a>
<h3>NDS context (NDSCTX)</h3>
<p>Specifies the complete path name of a default NetWare Directory Services context, associated with the tree specified by the NDSTREE parameter, to be used when a user issues i5/OS commands that use NDS objects.
</p>
<p>If the default NetWare Directory Services context is not set, it is defaulted to *ROOT.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default NDS context name does not change.
</dd>
<dt><b>*ROOT</b></dt>
<dd>The default NetWare Directory Services context is set to the root of the NDS tree.
</dd>
<dt><b><i>'NDS-context'</i></b></dt>
<dd>Specify the complete path name of the default NDS context name to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.NTWTCPPORT"></a>
<h3>NetWare TCP/IP port (NTWTCPPORT)</h3>
<p>Specifies the TCP/IP port number to be used by the system when communicating to NetWare/IP servers in the network.
</p>
<p>Valid values range from 50 through 50000. However, some of the ports in the range 1 through 1023 are used by system-supplied TCP/IP applications. If the user specifies one of these ports, it can affect the operation of those applications.
</p>
<p>See the assigned numbers RFC for the definition of port numbers currently used by TCP/IP applications.
</p>
<p>If the NTWTCPPORT parameter has never been set, it is defaulted to 20199.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default TCP/IP port number does not change.
</dd>
<dt><b><i>TCP/IP-port-number</i></b></dt>
<dd>Specify the TCP/IP port number to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.NTWTCPSVRL"></a>
<h3>NetWare/IP server list (NTWTCPSVRL)</h3>
<p>Specifies the TCP/IP names of up to 100 NetWare/IP servers running the Enhanced Integration for NetWare NLM (NetWare loadable module).
</p>
<p>If the NTWTCPSVRL parameter has never been set, it is defaulted to *NONE.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The list of NetWare/IP servers does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>When *NONE is specified, the system will not use TCP/IP as the communication protocol when communicating to NetWare servers in the network.
</dd>
<dt><b><i>'NetWare/IP-server-name'</i></b></dt>
<dd>Specify the TCP/IP name of a NetWare/IP server running the Enhanced Integration for NetWare NLM.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.NDSTREELST"></a>
<h3>NDS tree list (NDSTREELST)</h3>
<p>Specify a list of default NetWare Directory Services tree information used by the iSeries network administration support to enroll profiles into the NDS tree. Each entry in the list will contain an NDS tree name and a list of default attributes associated with that tree. If there are no entries in the list, then the default is to do no further enrollment of any i5/OS profiles into the network.
</p>
<p>Up to 10 entries can be specified for this parameter. An entry consists of a value from each of the following elements.
</p>
<p>If the default NetWare Directory Services tree list is not set, it is defaulted to *NONE.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default NDS tree list entries do not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>When *NONE is specified, the default is to not enroll any i5/OS profile updates.
</dd>
</dl>
<p><b>Element 1: NDS tree</b>
</p>
<dl>
<dt><b><i>'NDS-tree-name'</i></b></dt>
<dd>Specify the name of the NetWare Directory Services tree where the iSeries network administration support will enroll i5/OS profiles. The remaining elements describe the network server attributes which are associated with this NDS tree.
</dd>
</dl>
<p><b>Element 2: User object context</b>
</p>
<dl>
<dt><b><i>'NDS-user-object-context'</i></b></dt>
<dd>Specify the NDS context where profiles will be enrolled into the NDS tree.
</dd>
</dl>
<p><b>Element 3: Default server</b>
</p>
<p>The third element in this parameter Specifies the default NetWare Directory Services server to be used by the system when enrolling profiles into the NDS tree.
</p>
<dl>
<dt><b><u>*ANY</u></b></dt>
<dd>The system selects any active server to use when accessing the NDS tree.
</dd>
<dt><b><i>'NDS-server-name'</i></b></dt>
<dd>Specify the name of the default NDS server to be used by the system when enrolling profiles into the NDS tree. If this server is unavailable at the time the request is handled, the system attempts to find an active server that is available to handle the request.
</dd>
</dl>
<p><b>Element 4: Profile object</b>
</p>
<p>The fourth element in this parameter specifies a default NetWare Directory Services profile object that contains the profile login script to be used by the user when logging into the network. The NetWare distinguished name must be specified for this element.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No profile login script is used by the NetWare user.
</dd>
<dt><b><i>'NDS-profile-object-name'</i></b></dt>
<dd>Specify the distinguished name of the default NDS profile object containing the profile login script to be used by a user when logging into the network.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.WNTDMNLST"></a>
<h3>Windows server domain list (WNTDMNLST)</h3>
<p>Specifies a default list of Windows domains that will be used by the i5/OS user enrollment support to determine into which Windows domains i5/OS profiles are enrolled.
</p>
<p>Each entry in the list will contain a domain, a user account template name, and a group type. The user account template name is the name of a Windows user identity that is to be used when creating new Windows users.
</p>
<p>Up to 64 entries can be specified for this parameter. An entry consists of a value from each of the following elements. A domain name must be entered for each entry and must be unique within the list.
</p>
<p>If the WNTDMNLST parameter has never been set, it is defaulted to *NONE.
</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>When *NONE is specified, the default is to not enroll i5/OS profiles into Windows domains.
</dd>
</dl>
<p><b>Element 1: Domain</b>
</p>
<dl>
<dt><b><i>'domain-name'</i></b></dt>
<dd>Specify the name of the Windows domain where the i5/OS user enrollment support will enroll i5/OS profiles.
</dd>
</dl>
<p><b>Element 2: User template</b>
</p>
<p>Specifies the name of a Windows user that can be used as a template when creating new Windows users in the Windows domain.
</p>
<p>
<b>Note: </b>Changing this value will not affect Windows users that are already enrolled in the domain.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No Windows user account template is used when creating a new user identity in the Windows domain.
</dd>
<dt><b><i>'User-account-template-name'</i></b></dt>
<dd>Specify the name of a Windows user account to be used when creating new Windows user identities in the domain.
</dd>
</dl>
<p><b>Element 3: Group type</b>
</p>
<p>Specifies the type of group to be created in the Windows domain. This element is only used when enrolling group profiles.
</p>
<dl>
<dt><b><u>*GLOBAL</u></b></dt>
<dd>A global group is created in the Windows domain.
</dd>
<dt><b>*LOCAL</b></dt>
<dd>A local group is created in the Windows domain.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNWSA.WNTLCLSVRL"></a>
<h3>Windows local server list (WNTLCLSVRL)</h3>
<p>Specifies a default list of Windows servers that will be used by the i5/OS user enrollment support to determine in which local Windows servers to enroll i5/OS profiles. Only those server names associated with locally configured Integrated xSeries Servers can be specified in this list.
</p>
<p>Each entry in the list will contain a server name and associated user account template name. The user account template name is the Windows user account to be used when creating new Windows user identities on the server.
</p>
<p>Up to 64 entries can be specified for this parameter. An entry consists of a value from each of the following elements. A server name must be entered for each entry and must be unique within the list.
</p>
<p>If the WNTLCLSVRL parameter has never been set, it is defaulted to *NONE.
</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>When *NONE is specified, the default is to not enroll i5/OS profiles into local Windows servers.
</dd>
</dl>
<p><b>Element 1: Server</b>
</p>
<dl>
<dt><b><i>'server-name'</i></b></dt>
<dd>Specify the name of a Windows local server where the i5/OS user enrollment support will enroll i5/OS profiles. This server must be a locally configured Integrated xSeries Server.
</dd>
</dl>
<p><b>Element 2: User template</b>
</p>
<p>Specifies the name of a Windows user that can be used as a template when creating new Windows user identities on the local server.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No Windows user account template is used when creating a new user identity on the Windows server.
</dd>
<dt><b><i>'User-account-template-name'</i></b></dt>
<dd>Specify the name of a Windows user account to be used when creating new Windows user identities on the local server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNWSA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Setting Network Server Attributes for Windows</b>
</p>
<p>
<pre>
CHGNWSA DFTSVRTYPE(*WINDOWS)
WNTDMNLST((DMN01 USRTMP1) (DMN02))
WNTLCLSVRL((LCLSVR1 TMPL1) (LCLSRV2 *NONE))
</pre>
</p>
<p>The default server type is set to *WINDOWS. The default Windows domain list will be set to enroll profiles into domain DMN01 using user account USRTMP1 and into domain DMN02. Any Windows groups that are created in the domain will be created as global groups.
</p>
<p>The Windows local server default list will be set to enroll profiles into local server LCLSVR1 using user account template TMPL1 and into local server LCLSRV2.
</p>
<p><b>Example 2: Setting Network Server Attributes for NetWare</b>
</p>
<p>
<pre>
CHGNWSA NDSTREE(NWTREE1)
NDSCTX(.MARKETING.HDQTRS.IBM)
NDSTREELST(NWTREE1 NDSSVR1
MARKETING.HDQTRS.IBM *NONE)
NTW3SVRLST(NTW3SVR2 NTW3SVR3)
</pre>
</p>
<p>The above command will change the system default NDS tree to be NWTREE1 and the default context to MARKETING.HDQTRS.IBM. The tree list consists of one entry for NDS tree NWTREE1 with a default server of NDSSVR1, default user object context of MARKETING.HDQTRS.IBM and no default profile object name. The NetWare 3.12 default server list is set to include servers NTW3SVR2 and NTW3SVR3.
</p>
<p><b>Example 3: Setting Network Server Attributes for NetWare/IP</b>
</p>
<p>
<pre>
CHGNWSA NDSTREE(NWTREE1)
NDSCTX(.MARKETING.HDQTRS.IBM)
NDSTREELST(NWTREE1 NTWS1
MARKETING.HDQTRS.IBM *NONE)
NTW3SVRLST(NTWS2 NTWS3)
NTWTCPSVRL(NTWS1 NTWS2)
</pre>
</p>
<p>The above command will change the system default NDS tree to be NWTREE1 and the default context to MARKETING.HDQTRS.IBM. The tree list consists of one entry for NDS tree NWTREE1 with a default server of NTWS1, default user object context of MARKETING.HDQTRS.IBM and no default profile object name. The NetWare 3.12 default server list is set to include servers NTWS2 and NTWS3. The NetWare/IP default server list is set to include servers NTWS1 and NTWS2. Thus, NTWS1 and NTWS3 will use TCP/IP as the communication protocol.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNWSA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA44F</b></dt>
<dd>Network server attributes not changed. See previous messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNWSA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>