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

174 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>Set Upgrade Environment (SETUPGENV)</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="SETUPGENV.Top_Of_Page"></a>
<h2>Set Upgrade Environment (SETUPGENV)</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="#SETUPGENV.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SETUPGENV.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SETUPGENV.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SETUPGENV"></a>
<p>The Set Upgrade Environment (SETUPGENV) command prompts the user for information that is required to help the user plan for and perform the upgrade. The information that is gathered is stored in library QUPGRADE.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETUPGENV.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="#SETUPGENV.UPGENV"><b>UPGENV</b></a></td>
<td valign="top">Upgrade environment</td>
<td valign="top"><i>Character value</i>, *NEW, *UPGENVID</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SETUPGENV.TGTRLS"><b>TGTRLS</b></a></td>
<td valign="top">Target release</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#SETUPGENV.TGTPRC"><b>TGTPRC</b></a></td>
<td valign="top">Target processor</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#SETUPGENV.MERGE"><b>MERGE</b></a></td>
<td valign="top">Merge with Advanced/36</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#SETUPGENV.UPGENVID"><b>UPGENVID</b></a></td>
<td valign="top">Upgrade environment identifier</td>
<td valign="top"><i>Name</i>, *SRLNBR</td>
<td valign="top">Optional, Positional 5</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SETUPGENV.UPGENV"></a>
<h3>Upgrade environment (UPGENV)</h3>
<p>Specifies whether a new upgrade environment is being created or if you want to work with an existing environment.
</p>
<dl>
<dt><b>*NEW</b></dt>
<dd>Specifies a new upgrade environment is being created.
</dd>
<dt><b>*UPGENVID</b></dt>
<dd>Specifies that you want to work with an existing upgrade environment. The identifier of the existing upgrade environment is specified in the upgrade environment identifier field.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETUPGENV.TGTRLS"></a>
<h3>Target release (TGTRLS)</h3>
<p>Specifies the target release to which you intend to upgrade. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW.
</p>
<dl>
<dt><b><i>target-release</i></b></dt>
<dd>Specify the release level in the format VxRxMx. Valid values depend on the current version, release, and modification level, and they change with each new release.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETUPGENV.TGTPRC"></a>
<h3>Target processor (TGTPRC)</h3>
<p>Specify the feature code of the iSeries processor you expect for your target system. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW.
</p>
<p>The processors listed are the valid target processors for upgrading your source iSeries system. Other valid processors may be entered but the upgrade would represent an unsupported upgrade.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Specifies the smallest processor necessary to provide similar performance to that of the source system.
</dd>
<dt><b>target-processor</b></dt>
<dd>Specifies the four digit feature code of the target processor. Valid values depend on the source and target releases.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETUPGENV.MERGE"></a>
<h3>Merge with Advanced/36 (MERGE)</h3>
<p>Indicates whether System/36 operating system (SSP) will be running as guest on the target system. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Indicates this system will not be merged with a System/36
</dd>
<dt><b>*YES</b></dt>
<dd>Indicates this system will be merged with a System/36
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETUPGENV.UPGENVID"></a>
<h3>Upgrade environment identifier (UPGENVID)</h3>
<p>Specifies the identifier associated with an upgrade environment. You may develop several upgrade environments as you are planning the order for your upgrade. Each environment may use different values and upgrade methods to help you decide which upgrade method and approach is best for you and your business. Only one upgrade environment will be used for upgrade preparation and the upgrade.
</p>
<dl>
<dt><b>*SRLNBR</b></dt>
<dd>Specifies the default name for the upgrade environment. The upgrade environment identifier for this environment will be the serial number of this system appended to the letter 'Q', for example, Q0100A12.
</dd>
<dt><b><i>upgrade-environment-identifier</i></b></dt>
<dd>Specifies a character name as the upgrade environment identifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETUPGENV.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETUPGENV.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#SETUPGENV.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>