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

277 lines
11 KiB
HTML
Raw 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>Work with NWS User Enrollment (WRKNWSENR)</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="WRKNWSENR.Top_Of_Page"></a>
<h2>Work with NWS User Enrollment (WRKNWSENR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKNWSENR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKNWSENR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKNWSENR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKNWSENR"></a>
<p>The Work with Network Server User Enrollment (WRKNWSENR) command works with a list of user profiles that the iSeries administration support has enrolled, or is currently enrolling, into the network.
</p>
<p>The information displayed differs depending on the value of the SVRTYPE parameter.
</p>
<ol>
<li>If SVRTYPE(*NWSA) is specified, the display shown depends on the value specified for the DFTSVRTYPE parameter in the network server attributes (CHGNWSA command). The DFTSVRTYPE values that are supported are *WINDOWS, *WINDOWSNT, and *NETWARE.
</li>
<li>If SVRTYPE(*NWSUSRA) is specified, the display shown depends on the value specified for the DFTSVRTYPE parameter in the network server user attributes (CHGNWSUSRA command) for the current user. The value in the network server user attributes that are valid for this command are *WINDOWS, *WINDOWSNT, and *NETWARE.
</li>
<li>If SVRTYPE(*WINDOWS) or (*WINDOWSNT) is specified, enrollment information is shown for i5/OS users enrolled into Windows domains and local servers.
</li>
<li>If SVRTYPE(*NETWARE) is specified, the display works with enrollment information for those i5/OS users being enrolled into NetWare Directory Services trees.
</li>
</ol>
<p>In general, the Work with Network Server User Enrollment display shows a list of servers or NetWare Directory Services trees and the current enrollment status for a list of i5/OS profiles being enrolled into each server or NetWare Directory Services tree.
</p>
<p>Specific options are available to work with individual profiles in the list. These options provide functions such as changing user profiles and changing network server user attributes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKNWSENR.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="#WRKNWSENR.USRPRF"><b>USRPRF</b></a></td>
<td valign="top">User profile</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKNWSENR.PRFTYPE"><b>PRFTYPE</b></a></td>
<td valign="top">Profile type</td>
<td valign="top"><b><u>*USER</u></b>, *GROUP</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#WRKNWSENR.SVRTYPE"><b>SVRTYPE</b></a></td>
<td valign="top">Server type</td>
<td valign="top"><b><u>*NWSUSRA</u></b>, *WINDOWS, *NWSA, *NETWARE, *WINDOWSNT</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#WRKNWSENR.NDSTREE"><b>NDSTREE</b></a></td>
<td valign="top">NDS tree</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *NWSA, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKNWSENR.SERVER"><b>SERVER</b></a></td>
<td valign="top">Server</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *NWSA, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKNWSENR.DOMAIN"><b>DOMAIN</b></a></td>
<td valign="top">Domain</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *NWSA, *NONE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKNWSENR.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>Specifies the name of a profile.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The enrollment status for all profiles is displayed.
</dd>
<dt><b><i>generic*-user-name</i></b></dt>
<dd>Specify the generic name of the profile to be displayed. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all users with names that begin with the generic name, and for which the user has authority, are shown. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete user name.
</dd>
<dt><b><i>profile-name</i></b></dt>
<dd>Specify the name of a profile to be displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKNWSENR.PRFTYPE"></a>
<h3>Profile type (PRFTYPE)</h3>
<p>Specifies which enrollment status should be displayed.
</p>
<dl>
<dt><b><u>*USER</u></b></dt>
<dd>A list of i5/OS users and their enrollment status is displayed. From this display an alternate view is available which will show, for each user in this list, a list of i5/OS groups the user belongs to, provided the group is currently being enrolled into that server or NetWare Directory Services tree.
</dd>
<dt><b>*GROUP</b></dt>
<dd>A list of i5/OS groups and their enrollment status is displayed. An alternate view is available to display for each group in the list, those members of each group that are currently being enrolled into the server or NetWare Directory Services tree.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKNWSENR.SVRTYPE"></a>
<h3>Server type (SVRTYPE)</h3>
<p>Specifies which type of server to work with.
</p>
<dl>
<dt><b><u>*NWSUSRA</u></b></dt>
<dd>The server type from the network server user attributes (CHGNWSUSRA command) for the user profile running the WRKNWSENR command is used.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The server type in the network server attributes (CHGNWSA command) is used.
</dd>
<dt><b>*WINDOWS or *WINDOWSNT</b></dt>
<dd>Specifies that a list of users and groups enrolled into Windows domains and local servers are displayed.
<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 enrollment status for those profiles being enrolled into a NetWare network are displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKNWSENR.NDSTREE"></a>
<h3>NDS tree (NDSTREE)</h3>
<p>Specifies which NetWare Directory Services trees to work with.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All NetWare Directory Services trees that have users enrolled are listed.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The enrollment information for all the NetWare Directory Services trees identified by the NDSTREELST parameter in the network server attributes are displayed.
</dd>
<dt><b>*NONE</b></dt>
<dd>No enrollment information is listed for any NetWare Directory Services trees.
</dd>
<dt><b><i>generic*-tree-name</i></b></dt>
<dd>Specify the generic name of NetWare Directory Services trees that have users enrolled.
</dd>
<dt><b><i>'NDS tree-name'</i></b></dt>
<dd>Specify the name of a specific NetWare Directory Services tree that has users enrolled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKNWSENR.SERVER"></a>
<h3>Server (SERVER)</h3>
<p>Specifies which network servers to work with.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All servers that have users enrolled are listed.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The enrollment information for all the servers identified in the network server attributes is displayed.
<p>For *WINDOWS or *WINDOWSNT servers, the enrollment information for all servers defined by the WNTLCLSVRL parameter are displayed.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>No enrollment information is listed for any servers. This is valid only when SVRTYPE(*NETWARE) is specified.
</dd>
<dt><b><i>generic*-server-name</i></b></dt>
<dd>Specify the generic name of the server.
</dd>
<dt><b><i>server-name</i></b></dt>
<dd>Specify the name of a specific server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKNWSENR.DOMAIN"></a>
<h3>Domain (DOMAIN)</h3>
<p>Specifies which Windows domains to work with.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All domains that have users enrolled are listed.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The enrollment information for all the Windows domains identified by the WNTDMNLST parameter in the system network server attributes are displayed.
</dd>
<dt><b>*NONE</b></dt>
<dd>No enrollment information is listed for any Windows domains. Only the enrollment information for local Windows servers is displayed based on the SERVER parameter.
</dd>
<dt><b><i>generic*-domain-name</i></b></dt>
<dd>Specify the generic name of Windows domains that have users enrolled.
</dd>
<dt><b><i>'domain-name'</i></b></dt>
<dd>Specify the name of a specific Windows domain that has users enrolled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKNWSENR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Working with Windows User Enrollment</b>
</p>
<p>
<pre>
WRKNWSENR SVRTYPE(*WINDOWS) DOMAIN(DMN*) SERVER(SRV*)
</pre>
</p>
<p>This command displays a list of all i5/OS users that the i5/OS user enrollment support has enrolled into all Windows domains whose name starts with 'DMN' and all local servers that start with 'SRV'.
</p>
<p><b>Example 2: Working with NetWare NDS Tree User Enrollment</b>
</p>
<p>
<pre>
WRKNWSENR SVRTYPE(*NETWARE) NDSTREE(TREE1) SERVER(*NONE)
</pre>
</p>
<p>This command displays a list of all i5/OS users that the i5/OS user enrollment support has enrolled into NetWare Directory Services TREE1.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKNWSENR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA45A</b></dt>
<dd>Network server users not displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKNWSENR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>