241 lines
8.7 KiB
HTML
241 lines
8.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>Initialize NWS Configuration (INZNWSCFG)</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="INZNWSCFG.Top_Of_Page"></a>
|
|
<h2>Initialize NWS Configuration (INZNWSCFG)</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="#INZNWSCFG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#INZNWSCFG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#INZNWSCFG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="INZNWSCFG"></a>
|
|
<p>The Initialize NWS Configuration (INZNWSCFG) command initializes or resets a service processor (*SRVPRC) network server configuration when various service processor parameters are changed or need to be enabled.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public exclude (*EXCLUDE) authority. When this command is shipped, authority is issued only to the security officer. The security officer can grant the use of this command to other users.
|
|
</li>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) and security administrator (*SECADM) special authorities to use this command.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="INZNWSCFG.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="#INZNWSCFG.NWSCFG"><b>NWSCFG</b></a></td>
|
|
<td valign="top">Network server configuration</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#INZNWSCFG.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Processing option</td>
|
|
<td valign="top">*INIT, *CHGSPAUT, *REGEN, *SYNC</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#INZNWSCFG.SPAUT"><b>SPAUT</b></a></td>
|
|
<td valign="top">SP authentication</td>
|
|
<td valign="top">Single values: *DFT<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: User password</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="INZNWSCFG.NWSCFG"></a>
|
|
<h3>Network server configuration (NWSCFG)</h3>
|
|
<p>Specifies the name of the network server configuration.
|
|
</p>
|
|
<p>This *NWSCFG object must have been created with *SRVPRC specified for the <b>Configuration type (TYPE)</b> parameter on the Create NWS Configuration (CRTNWSCFG) command.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the service processor network server configuration to be processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZNWSCFG.OPTION"></a>
|
|
<h3>Processing option (OPTION)</h3>
|
|
<p>Specifies option to perform with the service processor network server configuration.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*INIT</b></dt>
|
|
<dd>Initialize a new service processor.
|
|
<p>
|
|
<b>Note: </b>This option is used to configure a service processor that has never been configured before such as when a new system is put into service or has had a service processor field replacement performed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A new user name and password must be specified on the <b>SP authentication (SPAUT)</b> parameter unless INZSP(*NONE) was specified in the corresponding <b>CRTNWSCFG</b> command
|
|
</p>
|
|
</dd>
|
|
<dt><b>*CHGSPAUT</b></dt>
|
|
<dd>Change the service processor user name and password to the new values specified on the <b>SP authentication (SPAUT)</b> parameter.
|
|
</dd>
|
|
<dt><b>*REGEN</b></dt>
|
|
<dd>Request that the service processor regenerate a self signed certificate. This option is used if the service processor's certificate has expired, or if a new certificate and password are desired at any time before the certificate expires.
|
|
<p>
|
|
<b>Note: </b>This option is only valid when INZSP(*AUTO) is specified in the corresponding <b>CRTNWSCFG</b> command.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A new password must be specified on the <b>SP authentication (SPAUT)</b> parameter unless INZSP(*NONE) was specified in the corresponding <b>CRTNWSCFG</b> command
|
|
</p>
|
|
</dd>
|
|
<dt><b>*SYNC</b></dt>
|
|
<dd>
|
|
<p>Synchronize the self-signed certificate from the service processor. This option is used if multiple service processor network server configurations are used for the same system or the service processor network server configuration has been restored from backup and the service processor's certificate must be synchronized. The current user name and password for the service processor must be specified on the <b>SP authentication (SPAUT)</b> parameter to perform this option.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZNWSCFG.SPAUT"></a>
|
|
<h3>SP authentication (SPAUT)</h3>
|
|
<p>Specifies the service processor user name and password. This is used to authenticate and secure the service processor.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The *DFT value is only valid when INZSP(*NONE) was specified in the corresponding <b>CRTNWSCFG</b> command.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The default service processors userid and password are used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: User name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-string</i></b></dt>
|
|
<dd>Specify a name that represents the host configuration that owns the service processor. It is suggested that the remote system network server configuration name be used. If multiple remote system network server configurations use the same service processor at different times, each configuration must contain the same user name and password.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: User password</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-string</i></b></dt>
|
|
<dd>Specify the service processor password. Password must be at least 5 characters in length and contain at least one alphabetic character and one numeric or symbolic character.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INZNWSCFG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Regenerate Service Processor Certificate</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
INZNWSCFG NWSCFG(MYCONFIG)
|
|
OPTION(*REGEN)
|
|
SPAUT(username password)
|
|
</pre>
|
|
</p>
|
|
<p>This command regenerates the remote system's service processor certificate then changes the user name and password.
|
|
</p>
|
|
<p><b>Example 2: Change Service Processor User Name and Password</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
INZNWSCFG NWSCFG(MYCONFIG)
|
|
OPTION(*CHGSPAUT)
|
|
SPAUT(username password)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the user name and password used to secure the service processor.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INZNWSCFG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0910</b></dt>
|
|
<dd>Password not valid for system.
|
|
</dd>
|
|
<dt><b>CPF96CB</b></dt>
|
|
<dd>Network server configuration &1 not found.
|
|
</dd>
|
|
<dt><b>CPF96CD</b></dt>
|
|
<dd>Network server configuration type &2 is not valid.
|
|
</dd>
|
|
<dt><b>CPF96CE</b></dt>
|
|
<dd>Password matches the previous value.
|
|
</dd>
|
|
<dt><b>CPF96CF</b></dt>
|
|
<dd>Errors processing network server configuration &1.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9899</b></dt>
|
|
<dd>Error occurred during processing of command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZNWSCFG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|