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

190 lines
6.7 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 RWS Controller Password (CHGRWSPWD)</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="CHGRWSPWD.Top_Of_Page"></a>
<h2>Change RWS Controller Password (CHGRWSPWD)</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="#CHGRWSPWD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGRWSPWD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGRWSPWD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGRWSPWD"></a>
<p>The Change RWS Controller Password (CHGRWSPWD) command changes the password for the specified remote workstation controller. The remote workstation controller password is used to access certain 5494 Utility Program functions.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>You must have *SECADM special authority to use this command.
</li>
<li>For the command to be successful, the specified remote workstation controller and associated APPC device must be active on the local system.
</li>
<li>If you attempt to use this command while the 5494 Utility Program is in use with the specified controller the command will fail.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGRWSPWD.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="#CHGRWSPWD.CTLD"><b>CTLD</b></a></td>
<td valign="top">Controller description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGRWSPWD.RMTPWD"><b>RMTPWD</b></a></td>
<td valign="top">Remote password</td>
<td valign="top"><i>Simple name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGRWSPWD.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">Local location</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGRWSPWD.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGRWSPWD.CTLD"></a>
<h3>Controller description (CTLD)</h3>
<p>Specifies the name of the 5494 remote workstation controller description.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGRWSPWD.RMTPWD"></a>
<h3>Remote password (RMTPWD)</h3>
<p>Specifies the new password to set in the remote control unit. The new password will replace the old password if a password already exists.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGRWSPWD.LCLLOCNAME"></a>
<h3>Local location (LCLLOCNAME)</h3>
<p>Specifies the local location name used to establish a conversation with the remote workstation controller.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The location name used is the same as the local location name identified in the APPC device associated with the remote workstation controller.
</dd>
<dt><b><i>local-location-name</i></b></dt>
<dd>Specify a location name to identify the local system to the remote workstation controller. When the session maximum has been reached on the mode used for nonprogrammable workstations, the location name specified must be different than the local location name identified in APPC device associated with the remote workstation controller, otherwise the command will fail.
<p>
<b>Note: </b>If you specify a local location name which does not exist on the system, a local configuration list entry is automatically created for the specified local location name.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGRWSPWD.MODE"></a>
<h3>Mode (MODE)</h3>
<p>Specifies the mode name used to establish a conversation with the remote workstation controller.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The mode depends on the value specified for the local location name (LCLLOCNAME) parameter. If the value specified for LCLLOCNAME is *LOC, then the mode is the same as the mode used for nonprogrammable workstation sessions. Otherwise, the mode is #INTER.
</dd>
<dt><b>*NETATR</b></dt>
<dd>The mode in the network attributes is used.
</dd>
<dt><b><i>mode-name</i></b></dt>
<dd>Specify a mode name. Specify BLANK for a mode name consisting of eight blank characters.
<p>
<b>Note: </b>SNASVCMG and CPSVCMG are reserved names and cannot be specified.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGRWSPWD.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGRWSPWD CTLD(L5494RMT) RMTPWD(NEWPASS)
</pre>
</p>
<p>This command changes the 5494 remote workstation controller password to NEWPASS.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGRWSPWD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2625</b></dt>
<dd>Not able to allocate object &amp;1.
</dd>
<dt><b>CPF2634</b></dt>
<dd>Not authorized to object &amp;1.
</dd>
<dt><b>CPF2703</b></dt>
<dd>Controller description &amp;1 not found.
</dd>
<dt><b>CPF8104</b></dt>
<dd>Controller description &amp;4 damaged.
</dd>
<dt><b>CPF8105</b></dt>
<dd>Device description &amp;4 damaged.
</dd>
<dt><b>CPF90A8</b></dt>
<dd>*SECADM special authority required to do requested operation.
</dd>
<dt><b>CPF91E0</b></dt>
<dd>Operation on controller &amp;2 failed with reason code &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRWSPWD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>