248 lines
8.0 KiB
HTML
248 lines
8.0 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>Add Nickname (ADDNCK)</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="ADDNCK.Top_Of_Page"></a>
|
|
<h2>Add Nickname (ADDNCK)</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="#ADDNCK.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDNCK.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDNCK.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDNCK"></a>
|
|
<p>The Add Nickname (ADDNCK) command is used to add a nickname to the system distribution directory. The nickname must be unique if it is a public nickname. The nickname must be unique only for the owner if it is a private nickname.
|
|
</p>
|
|
<p>A <b>nickname</b> is a short version of either a directory entry or a distribution list name. More information about nicknames is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDNCK.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" rowspan="3"><a href="#ADDNCK.NCK"><b>NCK</b></a></td>
|
|
<td valign="top">Nickname</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Nickname</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Access</td>
|
|
<td valign="top">
|
|
<b><u>*PRIVATE</u></b>, *PUBLIC</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDNCK.USRID"><b>USRID</b></a></td>
|
|
<td valign="top">User identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDNCK.LSTID"><b>LSTID</b></a></td>
|
|
<td valign="top">List identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: List ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: List ID qualifier</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDNCK.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Nickname description</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDNCK.NCK"></a>
|
|
<h3>Nickname (NCK)</h3>
|
|
<p>Specifies the nickname to be added and the ability of users to access the nickname.
|
|
</p>
|
|
<p>The possible nickname value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>nickname</i></b></dt>
|
|
<dd>Specify the nickname you are adding.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible nickname access values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRIVATE</u></b></dt>
|
|
<dd>The nickname cannot be shared with other users. It can be accessed and changed only by the owner.
|
|
</dd>
|
|
<dt><b>*PUBLIC</b></dt>
|
|
<dd>The nickname can be shared with other users. It can be accessed by any user on the local system, but it can be changed only by a user with security administrator (*SECADM) authority or by the owner.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNCK.USRID"></a>
|
|
<h3>User identifier (USRID)</h3>
|
|
<p>Specifies the two-part user identifier for which a user nickname is being added. Both the user ID and address elements must be specified. More information about specifying the user ID and address is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter cannot be specified when the LSTID parameter is specified.
|
|
</p>
|
|
<p>The possible user ID value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>user-ID</i></b></dt>
|
|
<dd>Specify the user ID for this nickname. A maximum of 8 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>The Possible user address value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>user-address</i></b></dt>
|
|
<dd>Specify the address for this nickname. A maximum of 8 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNCK.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the two-part list identifier of the distribution list for which a list nickname is being added. Both the list identifier and qualifier elements must be specified.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter cannot be specified when the USRID parameter is specified.
|
|
</p>
|
|
<p>The possible list identifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID</i></b></dt>
|
|
<dd>Specify the list identifier (ID) of the distribution list.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible list qualifier value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>list-ID-qualifier</i></b></dt>
|
|
<dd>Specify the list ID qualifier of the distribution list.
|
|
<p>
|
|
<b>Note: </b>The distribution list identifier has two parts, the ID and the qualifier, separated by at least one space. If lowercase characters are specified, the system changes them to uppercase.
|
|
</p>
|
|
<p>The naming rules for the two-part list ID are identical to the rules for the user ID and address. A complete description of these rules is in the SNA Distribution Services book, SC41-5410.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDNCK.TEXT"></a>
|
|
<h3>Nickname description (TEXT)</h3>
|
|
<p>Specifies the description of the nickname.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>The default description is used for the text. The default description is the first description associated with the specified USERID or LISTID parameter.
|
|
</dd>
|
|
<dt><b><i>'nickname-description'</i></b></dt>
|
|
<dd>Specify a description to further identify the nickname. A maximum of 50 characters can be specified and must be enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNCK.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ADDNCK NCK(SEC44A *PUBLIC) USRID(XZWS44A RCHAS1)
|
|
TEXT('Secretary for Department 44A')
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a public user nickname which is a short version of the User ID and Address XZWS44A&rbl.RCHAS1. If this nickname is unique it is added to the directory.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDNCK.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8360</b></dt>
|
|
<dd>Not enough storage for commitment control operation.
|
|
</dd>
|
|
<dt><b>CPF8AA1</b></dt>
|
|
<dd>Library QUSRSYS not completely installed.
|
|
</dd>
|
|
<dt><b>CPF905C</b></dt>
|
|
<dd>Error occurred trying to find a translation table.
|
|
</dd>
|
|
<dt><b>CPF9838</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</dd>
|
|
<dt><b>CPF9A89</b></dt>
|
|
<dd>Nickname function not successful.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|