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

135 lines
5.2 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 NDS Context (CHGNDSCTX)</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="CHGNDSCTX.Top_Of_Page"></a>
<h2>Change NDS Context (CHGNDSCTX)</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="#CHGNDSCTX.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGNDSCTX.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGNDSCTX.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGNDSCTX"></a>
<p>The Change NetWare Directory Services Context (CHGNDSCTX) command changes the NDS current context to the context specified in the command. The current context is used by iSeries commands to locate and create NDS objects in the NDS tree. The NDS current context is changed only for the job in which the command is run. The change remains in effect until another CHGNDSCTX command is run or until the job ends.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGNDSCTX.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="#CHGNDSCTX.NDSCTX"><b>NDSCTX</b></a></td>
<td valign="top">NDS context</td>
<td valign="top"><i>Path name</i>, <b><u>*SAME</u></b>, *NWSA, *NWSUSRA, *ROOT</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGNDSCTX.NDSTREE"><b>NDSTREE</b></a></td>
<td valign="top">NDS tree</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NWSA, *NWSUSRA</td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGNDSCTX.NDSCTX"></a>
<h3>NDS context (NDSCTX)</h3>
<p>Specifies the NetWare Directory Services context to be used when changing the current context.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The NetWare Directory Services context specified in the system network server attributes is used. The default NDS context name in the network server attributes can be changed using the Change Network Server Attributes (CHGNWSA) command.
</dd>
<dt><b>*NWSUSRA</b></dt>
<dd>The NetWare Directory Services context specified in the network server user attributes for the current user profile is used. The default NDS context name for a specific user profile can be changed using the Change Network Server User Attributes (CHGNWSUSRA) command.
</dd>
<dt><b>*ROOT</b></dt>
<dd>The current context is set to the root of the NDS tree.
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the path name of the NDS context to be used. This context will become the current working context for the job. A single period can be used to move up one level in the NDS tree. An additional period can be added for each additional level to be moved up.
<p>To set the new context from the root, a period can be specified in front of the context.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGNDSCTX.NDSTREE"></a>
<h3>NDS tree (NDSTREE)</h3>
<p>Specifies the NetWare Directory Services tree to be used when changing the current context.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NWSA</b></dt>
<dd>The tree name from the network server attributes is used.
</dd>
<dt><b>*NWSUSRA</b></dt>
<dd>The tree name from the network server user attributes for the current user profile is used.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the NDS tree name to be used when changing the context.
<p>
<b>Note: </b>When changing the current context to a context in a different NDS tree, the value specified for the NDSCTX parameter must be a <b>distinguished name</b> (beginning with a period).
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGNDSCTX.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGNDSCTX.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>FPE0109</b></dt>
<dd>NetWare Directory Services context not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGNDSCTX.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>