321 lines
10 KiB
HTML
321 lines
10 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 Nickname (CHGNCK)</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="CHGNCK.Top_Of_Page"></a>
|
|
<h2>Change Nickname (CHGNCK)</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="#CHGNCK.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGNCK.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGNCK.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGNCK"></a>
|
|
<p>The Change Nickname (CHGNCK) command is used to change an existing nickname in the system distribution directory.
|
|
</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>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have security administrator (*SECADM or *ALLOBJ) authority to change a public nickname that you do not own. No special authority is needed for you to change a public or private nickname that you own.
|
|
</li>
|
|
<li>Only the owner can change a private nickname. No special authority is needed. However, to change the ownership of a nickname that you own, you must have at least change (*CHANGE) authority to the user profile of the user to be named as the new owner.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGNCK.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="#CHGNCK.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, Key, 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"><a href="#CHGNCK.OWNER"><b>OWNER</b></a></td>
|
|
<td valign="top">Owner</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNCK.NEWACCESS"><b>NEWACCESS</b></a></td>
|
|
<td valign="top">New access</td>
|
|
<td valign="top">*PRIVATE, *PUBLIC, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGNCK.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Nickname description</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGNCK.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>, <b><u>*SAME</u></b></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="#CHGNCK.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>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: List ID qualifier</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGNCK.NCK"></a>
|
|
<h3>Nickname (NCK)</h3>
|
|
<p>Specifies the existing nickname that is being changed and the access of the nickname.
|
|
</p>
|
|
<p>The possible nickname value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>nickname</i></b></dt>
|
|
<dd>Specify the nickname you are changing.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible nickname access values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRIVATE</u></b></dt>
|
|
<dd>The private nickname is to be changed. Private nicknames can be changed only by the owner.
|
|
</dd>
|
|
<dt><b>*PUBLIC</b></dt>
|
|
<dd>The public nickname is to be changed. Public nicknames 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="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNCK.OWNER"></a>
|
|
<h3>Owner (OWNER)</h3>
|
|
<p>Specifies the user profile name of the user who is to own the nickname. The user profile named must exist on the system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>user-profile-name</i></b></dt>
|
|
<dd>Specify the user profile name of the user to whom the nickname is being assigned.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNCK.NEWACCESS"></a>
|
|
<h3>New access (NEWACCESS)</h3>
|
|
<p>Specifies the new access of the nickname.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change. The value is the value on the ACCESS parameter.
|
|
</dd>
|
|
<dt><b>*PRIVATE</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 the owner or a user with security administrator (*SECADM) authority.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNCK.TEXT"></a>
|
|
<h3>Nickname description (TEXT)</h3>
|
|
<p>Specifies the new description of the nickname.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>'nickname-description'</i></b></dt>
|
|
<dd>Specify the description that further identifies 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="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNCK.USRID"></a>
|
|
<h3>User identifier (USRID)</h3>
|
|
<p>Specifies the new identifier of the user for whom the user nickname is being changed. 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>Both the user ID and address elements must be specified unless *SAME is specified.
|
|
</p>
|
|
<p>The possible value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGNCK.LSTID"></a>
|
|
<h3>List identifier (LSTID)</h3>
|
|
<p>Specifies the new list identifier of the distribution list for the list nickname being changed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter cannot be specified when the USRID parameter is specified.
|
|
</p>
|
|
<p>Both the list identifier and qualifier elements must be specified unless *SAME is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGNCK.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGNCK NCK(SEC44A *PRIVATE) NEWACCESS(*PUBLIC)
|
|
TEXT('Secretary for Area 44A') USRID(XZWS44A RCHVMP2)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the access, nickname description, and user ID of the nickname SEC44A. If the nickname is a user nickname and the user has proper authority to the nickname, the nickname is changed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGNCK.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>CPF9A80</b></dt>
|
|
<dd>Public nickname &1 in use.
|
|
</dd>
|
|
<dt><b>CPF9A89</b></dt>
|
|
<dd>Nickname function not successful.
|
|
</dd>
|
|
<dt><b>CPF9024</b></dt>
|
|
<dd>System cannot get correct record to finish operation.
|
|
</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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGNCK.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|