340 lines
12 KiB
HTML
340 lines
12 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>Start NetWare Connection (STRNTWCNN)</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="STRNTWCNN.Top_Of_Page"></a>
|
|
<h2>Start NetWare Connection (STRNTWCNN)</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="#STRNTWCNN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRNTWCNN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRNTWCNN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRNTWCNN"></a>
|
|
<p>The Start NetWare Connection (STRNTWCNN) command starts an authenticated connection to the specified server. This command is used to:
|
|
</p>
|
|
<ul>
|
|
<li>Start a connection when there is no password in the authentication entry for the server (the password value is *STRNTWCNN).
|
|
</li>
|
|
<li>Start a connection using authentication information different from that specified in the user profile authentication entry.
|
|
</li>
|
|
<li>To specify a preferred server for NetWare operations that might otherwise use a different server.
|
|
</li>
|
|
</ul>
|
|
<p>If a password is stored in the authentication entry, this command is not needed; the system will start and end connections as necessary.
|
|
</p>
|
|
<p>Connections can be authorized to be used only by the current job (AUTJOB(*)), or can be authorized to be used by any job running under the specified user profile (AUTJOB(*ANY)), for example, a batch job. Each user profile can only have one connection per job open to a given server at a time.
|
|
</p>
|
|
<p>For NetWare Directory Services trees, connections may be started to each server within the tree. The special value *ALL may be used to start connections to all servers. This could be used, for example, when copying from one server in the tree to another, or copying between partitions of the NDS tree. If multiple connections exist, operations that do not require a specific server will be performed using the first connection started.
|
|
</p>
|
|
<p>The NetWare backup services require that each user perform a separate authentication in addition to a normal login. The connection type (CNNTYPE) parameter allows you to specify that a *SAVRST authentication be performed for this purpose.
|
|
</p>
|
|
<p><b>Restrictions:</b> To start a connection for another user profile (specified in AUTUSR parameter), you need to have *USE authority to that user profile.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRNTWCNN.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="#STRNTWCNN.SERVER"><b>SERVER</b></a></td>
|
|
<td valign="top">Server</td>
|
|
<td valign="top"><i>Character value</i>, *ALL, *ANY</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.SVRTYPE"><b>SVRTYPE</b></a></td>
|
|
<td valign="top">Server type</td>
|
|
<td valign="top"><b><u>*SERVER</u></b>, *NDS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.NDSTREE"><b>NDSTREE</b></a></td>
|
|
<td valign="top">NDS tree</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SERVER</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.AUTUSR"><b>AUTUSR</b></a></td>
|
|
<td valign="top">Authorized user profile</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURRENT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.NDSCTX"><b>NDSCTX</b></a></td>
|
|
<td valign="top">NDS context</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*AUTE</u></b>, *USRPRF</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.NTWUSER"><b>NTWUSER</b></a></td>
|
|
<td valign="top">NetWare user</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*AUTE</u></b>, *USRPRF</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.PASSWORD"><b>PASSWORD</b></a></td>
|
|
<td valign="top">Password</td>
|
|
<td valign="top"><i>Character value</i>, *NONE, *AUTE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.AUTJOB"><b>AUTJOB</b></a></td>
|
|
<td valign="top">Authorized job</td>
|
|
<td valign="top"><b><u>*</u></b>, *ANY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.CNNTYPE"><b>CNNTYPE</b></a></td>
|
|
<td valign="top">Connection type</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 2 repetitions): <b><u>*USER</u></b>, *SAVRST</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRNTWCNN.CNNIDLTIME"><b>CNNIDLTIME</b></a></td>
|
|
<td valign="top">Connection idle time</td>
|
|
<td valign="top">1-9999, <b><u>*NOMAX</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRNTWCNN.SERVER"></a>
|
|
<h3>Server (SERVER)</h3>
|
|
<p>Specify the server to which the connection is to be started.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ANY</b></dt>
|
|
<dd>For *NDS servers, start a connection to any server within the NDS tree.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>For *NDS servers, start connections to all servers within the NDS tree.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the server to which the connection is to be started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.SVRTYPE"></a>
|
|
<h3>Server type (SVRTYPE)</h3>
|
|
<p>Specifies the type of server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SERVER</u></b></dt>
|
|
<dd>Use system information about the specified server to determine the server type. This value cannot be used when *ANY or *ALL is specified for the <b>Server (SERVER)</b> parameter.
|
|
</dd>
|
|
<dt><b>*NDS</b></dt>
|
|
<dd>The server is in a NetWare Directory Services tree.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.NDSTREE"></a>
|
|
<h3>NDS tree (NDSTREE)</h3>
|
|
<p>For *NDS servers, specifies the name of the NetWare Directory Services (NDS) tree to which the connection is to be started.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SERVER</u></b></dt>
|
|
<dd>Use system information about the specified server to determine the NDS tree name. This value cannot be used when *ANY or *ALL is specified for the SERVER parameter.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of NDS tree.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.AUTUSR"></a>
|
|
<h3>Authorized user profile (AUTUSR)</h3>
|
|
<p>Specifies the user profile authorized to use the connection.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The connection can only be used by jobs running under the current user profile.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user profile. The connection can only be used by jobs running under the specified user profile.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.NDSCTX"></a>
|
|
<h3>NDS context (NDSCTX)</h3>
|
|
<p>Specifies, for *NDS servers, the NetWare Directory Services context in which the NetWare user name is defined.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AUTE</u></b></dt>
|
|
<dd>Use the authentication entry for this tree in the user profile to determine the NDS directory context.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>Use the authorized user profile name as the NDS directory context name.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of NDS directory context.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.NTWUSER"></a>
|
|
<h3>NetWare user (NTWUSER)</h3>
|
|
<p>Specifies the NetWare user name used to authenticate the user.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AUTE</u></b></dt>
|
|
<dd>Use the authentication entry for the specified server or NDS tree in the user profile to determine the NetWare user name.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>Use the authorized user profile name as the NetWare user name.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the NetWare user name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.PASSWORD"></a>
|
|
<h3>Password (PASSWORD)</h3>
|
|
<p>Specifies the password to be used to verify the authority for the specified user.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AUTE</b></dt>
|
|
<dd>Use the password in the authentication entry for this server or NDS tree in the user profile.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No password is used to verify authority.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the password to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.AUTJOB"></a>
|
|
<h3>Authorized job (AUTJOB)</h3>
|
|
<p>Specifies the job authorized to use the connection. The connection can be used either by the current job, or by any job running under the specified user profile name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The connection can only be used by the current job. The connection will be closed when the job ends.
|
|
</dd>
|
|
<dt><b>*ANY</b></dt>
|
|
<dd>The connection can be used by any job running under the specified user profile. The connection must be ended by an End NetWare Connection (ENDNTWCNN) request.
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The QNETWARE file system requires a connection for the current job (AUTJOB(*)).
|
|
</li>
|
|
<li>If a connection cannot be started using an authentication entry, printing to a NetWare print server requires a connection for any job (AUTJOB(*ANY)).
|
|
</li>
|
|
<li>Connections for AUTJOB(*) are also ended if the QFPZAUT activation group is reclaimed (RCLACTGRP command).
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.CNNTYPE"></a>
|
|
<h3>Connection type (CNNTYPE)</h3>
|
|
<p>Specifies the types of authentication to be performed. NetWare backup services require a separate authentication in addition to a normal user login.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Both *USER and *SAVRST authentications will be performed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 2 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*USER</u></b></dt>
|
|
<dd>A normal user authentication will be done. This will allow the user to use administration and file system services other than save and restore.
|
|
</dd>
|
|
<dt><b>*SAVRST</b></dt>
|
|
<dd>Authentication to NetWare backup services will be performed. This option requires that the appropriate NetWare backup NLMs (TSAxxx) be loaded on the server.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRNTWCNN.CNNIDLTIME"></a>
|
|
<h3>Connection idle time (CNNIDLTIME)</h3>
|
|
<p>Specifies the idle time after which the connection will be closed. The idle time is the time since the most recent request to the server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOMAX</u></b></dt>
|
|
<dd>No idle time limit is specified. The connection will remain open until ended by an End NetWare Connection (ENDNTWCNN) request, or until the job is ended, whichever is sooner.
|
|
</dd>
|
|
<dt><b><i>1-9999</i></b></dt>
|
|
<dd>Specify the number of minutes of allowed idle time.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRNTWCNN.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRNTWCNN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>FPE0226</b></dt>
|
|
<dd>Connection not started to server &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRNTWCNN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|