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

383 lines
17 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Save Restore Configuration (SAVRSTCFG)</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="SAVRSTCFG.Top_Of_Page"></a>
<h2>Save Restore Configuration (SAVRSTCFG)</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="#SAVRSTCFG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SAVRSTCFG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SAVRSTCFG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SAVRSTCFG"></a>
<p>The Save/Restore Configuration (SAVRSTCFG) command saves and restores configuration information without requiring a dedicated system. The information saved and restored includes the following:
</p>
<ul>
<li>Configuration lists (*CFGL)
</li>
<li>Connection lists (*CNNL)
</li>
<li>Class-of-service descriptions (*COSD)
</li>
<li>Internet Packet Exchange descriptions (*IPXD)
</li>
<li>Mode descriptions (*MODD)
</li>
<li>NetBIOS descriptions (*NTBD)
</li>
</ul>
<p>The user profile of the system default owner (QDFTOWN) becomes the default owner of any objects being restored in the system when the profile of the owner is not known to the system.
</p>
<p>If an object already exists on the restore system, the public and private authorities of the existing object are kept. If the object does not exist in the library, all public authorities are restored, but any private authorities must be granted again.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, the user must have *SAVSYS authority, or object existence authority for (or be the owner of) each object specified if the object already exists on the system.
</li>
<li>This command is shipped with public *EXCLUDE authority.
</li>
<li>The user must have either *ALLOBJ authority or authority to the command.
</li>
<li>Changes made to the configuration while the SAVRSTCFG command is being run may not be reflected on the restore system, depending on when the changes occurred in relation to the send operation. If the operation cannot obtain a lock on a configuration object, a diagnostic message is issued; and the object is not saved and restored. The operation does not obtain the lock on a configuration object when a change or delete operation against the object does not complete before the default wait timer expires.
</li>
<li>If any system resource manager objects are in use, a message is issued and none of them are saved and restored. The commands which can cause this to happen are Work with Hardware Products (WRKHDWPRD) and Work with Hardware Resources (WRKHDWRSC). No display commands can cause the system resource manager database to lock. All other known functions do read-only operations.
</li>
<li>Both systems intended to participate in the save and restore operation must be connected to the same APPN network or, if the OptiConnect for I5/OS option is to be used, both systems must be joined by the OptiConnect for I5/OS hardware and software.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SAVRSTCFG.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="#SAVRSTCFG.OBJ"><b>OBJ</b></a></td>
<td valign="top">Objects</td>
<td valign="top">Single values: *ALL, *SRM<br>Other values (up to 300 repetitions): <i>Generic name, name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SAVRSTCFG.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#SAVRSTCFG.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object types</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 5 repetitions): *CFGL, *CNNL, *COSD, *MODD, *NTBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVRSTCFG.SRM"><b>SRM</b></a></td>
<td valign="top">System Resource Management</td>
<td valign="top"><b><u>*NONE</u></b>, *TRA</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVRSTCFG.PRECHK"><b>PRECHK</b></a></td>
<td valign="top">Object pre-check</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVRSTCFG.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
<td valign="top">Allow object differences</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *ALL<br>Other values (up to 3 repetitions): *AUTL, *OWNER, *PGP</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SAVRSTCFG.OBJ"></a>
<h3>Objects (OBJ)</h3>
<p>Specifies the objects to be restored. Specify the name of each object, or the generic name of each group of objects to restore. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an asterisk (*) is not specified with the name, the system assumes that the name is a complete object name.
</p>
<p>If the <b>Object types (OBJTYPE)</b> parameter has a value of *ALL, all the object types listed in the description of the OBJTYPE parameter are restored, if they have the specified names.
</p>
<p>System resource management (SRM) objects cannot be restored individually or by specifying a generic name. To restore only SRM objects, specify *SRM for this parameter and a value for the <b>System Resource Management (SRM)</b> parameter.
</p>
<p>This is a required parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All the device configuration objects are restored, depending on the values specified for the OBJTYPE parameter.
</dd>
<dt><b>*SRM</b></dt>
<dd>The device configuration objects are not restored, but system resource management (SRM) objects are restored based on the SRM parameter value.
<p><b>ATTENTION</b> You must specify SRM(*NONE) on the RSTCFG, unless the system you are restoring to is the exact same hardware configuration that the original configuration was saved on, to prevent the restore of the SRM information. If the SRM information is restored, the configuration objects may become unusable.
</p>
</dd>
</dl>
<p><b>Other values (up to 300 repetitions)</b>
</p>
<dl>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify one or more generic names of groups of objects in the specified library to restore.
<p>
<b>Note: </b>A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
</p>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify one or more names of specific objects to restore. Both generic names and specific names can be specified in the same command. A maximum of 300 object names can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVRSTCFG.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the remote location to connect with. Specify the remote location name using the format cccccccc or nnnnnnnn.cccccccc, where nnnnnnnn is the network identifier (ID) and cccccccc is the remote location name.
</p>
<dl>
<dt><b><i>remote-location-name</i></b></dt>
<dd>Specify the remote location name associated with the system to which you want to restore objects. The local network ID (LCLNETID) network attribute is used as the value of the network identifier.
</dd>
<dt><b><i>network-ID.location-name</i></b></dt>
<dd>Specify the network identifier and the remote location name associated with the system to which you want to restore objects.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVRSTCFG.OBJTYPE"></a>
<h3>Object types (OBJTYPE)</h3>
<p>Specifies the types of i5/OS system objects that are saved and restored.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All configuration object types that are specified by name are saved and restored. If OBJ(*ALL) is specified, all of the saved configuration objects are saved and restored. restored. The following types can be specified:
</dd>
<dt><b>*CFGL</b></dt>
<dd>All configuration list object types are saved and restored.
</dd>
<dt><b>*CNNL</b></dt>
<dd>All connection list object types are saved and restored.
</dd>
<dt><b>*COSD</b></dt>
<dd>All class-of-service description object types are saved and restored.
</dd>
<dt><b>*IPXD</b></dt>
<dd>All Internetwork Packet Exchange object types are saved and restored.
</dd>
<dt><b>*MODD</b></dt>
<dd>All mode description object types are saved and restored.
</dd>
<dt><b>*NTBD</b></dt>
<dd>All NetBIOS description object types are saved and restored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVRSTCFG.SRM"></a>
<h3>System Resource Management (SRM)</h3>
<p>Specifies the type of system resource management (SRM) information to be saved and restored. This parameter is valid only when *ALL or *SRM is specified on the OBJ parameter.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No SRM information is restored.
</dd>
<dt><b>*TRA</b></dt>
<dd>All token-ring adapter information is restored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVRSTCFG.PRECHK"></a>
<h3>Object pre-check (PRECHK)</h3>
<p>Specifies whether the save configuration operation ends if any of the objects satisfy the following conditions:
</p>
<ul>
<li>The objects were previously found to be damaged.
</li>
<li>The objects are locked by another job.
</li>
<li>The user does not have authority to save the objects.
</li>
</ul>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The save operation continues, saving only configuration and system resource management (SRM) objects that can be saved.
</dd>
<dt><b>*YES</b></dt>
<dd>The save operation ends before any data is written to the media if any configuration objects or system resource manager objects cannot be saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVRSTCFG.ALWOBJDIF"></a>
<h3>Allow object differences (ALWOBJDIF)</h3>
<p>Specifies whether differences are allowed between the saved objects and the restored objects.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>You must have all object (*ALLOBJ) special authority to specify any value other than *NONE for this parameter.
</li>
<li>If differences are found, the final message for the restore operation is an escape message rather than the normal completion message.
</li>
</ol>
<p>The types of differences include:
</p>
<ul>
<li>Authorization list: The saved object had an authorization list, and either the object exists on the system but does not have the same authorization list, or the object does not exist and it is being restored to a different system than the save system.
<p>
<b>Note: </b>This parameter has no effect when the saved object did not have an authorization list. If the object exists, it is restored with the authorization list of the existing object. If it does not exist, it is restored with no authorization list.
</p>
</li>
</ul>
<ul>
<li>Ownership: The owner of an object on the system is different than the owner of an object from the save operation.
</li>
</ul>
<ul>
<li>Primary Group: The primary group of an object on the system is different than the primary group of an object from the save operation.
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>None of the differences listed above are allowed on the restore operation. See the description of each individual value to determine how differences are handled.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>All of the differences listed above are allowed on the restore operation. See the description of each individual value to determine how differences are handled.
</dd>
</dl>
<p><b>Other values (up to 3 repetitions)</b>
</p>
<dl>
<dt><b>*AUTL</b></dt>
<dd>Authorization list differences are allowed. If the saved object had an authorization list and the object exists on the system but does not have the same authorization list, the object is restored with the authorization list of the existing object. If the saved object had an authorization list and the object does not exist and it is being restored to a different system than the save system, the object is restored and it is linked to the authorization list. If the authorization list does not exist, the public authority is set to *EXCLUDE.
<p>If this value is not specified, authorization list differences are not allowed. If the saved object had an authorization list and the object exists on the system but does not have the same authorization list, the object is not restored. If the saved object had an authorization list and the object does not exist and it is being restored to a different system than the save system, the object is restored, but it is not linked to the authorization list, and the public authority is set to *EXCLUDE.
</p>
</dd>
</dl>
<dl>
<dt><b>*OWNER</b></dt>
<dd>Ownership differences are allowed. If an object already exists on the system with a different owner than the saved object, the object is restored with the owner of the object on the system.
<p>If this value is not specified, ownership differences are not allowed. If an object already exists on the system with a different owner than the saved object, the object is not restored.
</p>
</dd>
</dl>
<dl>
<dt><b>*PGP</b></dt>
<dd>Primary group differences are allowed. If an object already exists on the system with a different primary group than the saved object, the object is restored with the primary group of the object on the system.
<p>If this value is not specified, primary group differences are not allowed. If an object already exists on the system with a different primary group than the saved object, the object is not restored.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SAVRSTCFG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Saving and Restoring Generic Objects</b>
</p>
<p>
<pre>
SAVRSTCFG OBJ(ABCD*) RMTLOCNAME(SYSTEM1) OBJTYPE(*CFGL)
ALWOBJDIF(*NONE)
</pre>
</p>
<p>This command saves and restores all objects whose names begin with ABCD and whose object type is configuration list (*CFGL). Only those objects that have no differences on SYSTEM1 will be restored.
</p>
<p><b>Example 2: Saving and Restoring All Objects</b>
</p>
<p>
<pre>
SAVRSTCFG OBJ(*ALL) RMTLOCNAME(SYSTEM1)
</pre>
</p>
<p>This command saves and restores all configuration objects whose types match the five object types listed on the OBJTYPE parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SAVRSTCFG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPCAD80</b></dt>
<dd>&amp;1 objects saved and restored.
</dd>
<dt><b>CPFAD8D</b></dt>
<dd>An error occurred during the &amp;1 operation.
</dd>
<dt><b>CPFAD80</b></dt>
<dd>Unable to establish connection from &amp;1 to &amp;2.
</dd>
<dt><b>CPFAD81</b></dt>
<dd>User profile &amp;1 not found on remote location &amp;2.
</dd>
<dt><b>CPFAD82</b></dt>
<dd>Remote location &amp;1 not found.
</dd>
<dt><b>CPFAD83</b></dt>
<dd>Remote location &amp;1 cannot be source location.
</dd>
<dt><b>CPFAD84</b></dt>
<dd>ObjectConnect internal error, function code &amp;1, return code &amp;2.
</dd>
<dt><b>CPFAD86</b></dt>
<dd>Location name &amp;1 unable to close &amp;2.
</dd>
<dt><b>CPFAD88</b></dt>
<dd>Unable to establish connection from &amp;1 to &amp;2.
</dd>
<dt><b>CPFAD93</b></dt>
<dd>APPC failure. Failure code is &amp;3.
</dd>
<dt><b>CPF389C</b></dt>
<dd>ObjectConnect internal error, function code &amp;1, return code &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVRSTCFG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>