424 lines
16 KiB
HTML
424 lines
16 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>Restore System Information (RSTSYSINF)</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="RSTSYSINF.Top_Of_Page"></a>
|
|
<h2>Restore System Information (RSTSYSINF)</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="#RSTSYSINF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RSTSYSINF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RSTSYSINF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RSTSYSINF"></a>
|
|
<p> The Restore System Information (RSTSYSINF) command restores the subset of system data and objects saved by the Save System Information (SAVSYSINF) command.
|
|
</p>
|
|
<p> RSTSYSINF is not to be used for system upgrades or migrations.
|
|
</p>
|
|
<p>Security related system values may not be restored if they have been locked. For information on how to lock and unlock security related system values, see the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>The QPWDLVL (Password level) system value will not be restored. See Planning Password Level Changes in Chapter 7 of the iSeries Security Reference, SC41-5302 before changing the QPWDLVL system value. Also, based on the current setting of the QPWDLVL system value, QPWDMAXLEN (Maximum password length), QPWDMINLEN (Minimum password length), and QPWDVLDPGM (Password validation program) system values may not be restored.
|
|
</p>
|
|
<p>Note: The RSTSYSINF command issues several restore commands for restoring objects. Parameters may or may not be used for all restore commands.
|
|
</p>
|
|
<p> For more information, refer to the Backup and Recovery information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RSTSYSINF.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="#RSTSYSINF.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top">Single values: *SAVF<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTSYSINF.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top">Single values: <b><u>*MOUNTED</u></b><br>Other values (up to 75 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTSYSINF.SEQNBR"><b>SEQNBR</b></a></td>
|
|
<td valign="top">Sequence number</td>
|
|
<td valign="top">1-16777215, <b><u>*SEARCH</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTSYSINF.ENDOPT"><b>ENDOPT</b></a></td>
|
|
<td valign="top">End of media option</td>
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTSYSINF.SAVF"><b>SAVF</b></a></td>
|
|
<td valign="top">Save file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Save file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RSTSYSINF.OPTFILE"><b>OPTFILE</b></a></td>
|
|
<td valign="top">Optical file</td>
|
|
<td valign="top"><i>Path name</i>, <b><u>*</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTSYSINF.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *PRINT, *OUTFILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTSYSINF.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTSYSINF.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RSTSYSINF.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device used for the restore operation. The device name must already be known on the system by a device description.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SAVF</b></dt>
|
|
<dd>The restore operation is done using the save file specified for the <b>Save file (SAVF)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
|
<dd>Specify the name of the optical device used for the restore operation.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>tape-media-library-device-name</i></b></dt>
|
|
<dd>Specify the name of the tape media library device used for the restore operation.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>tape-device-name</i></b></dt>
|
|
<dd>Specify the names of one or more tape devices used for the restore operation. If a virtual tape device is used, it must be the only device specified. If you are using more than one tape device (up to a maximum of four), specify the names of the devices in the order in which they are used. When more than one tape volume is to be restored, using more than one tape device permits one tape volume to be rewound while another tape device processes the next tape volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifiers of the media or the cartridge identifiers of tapes in a tape media library device, from which the objects are being restored. The volumes must be in the same order as they were when the data was saved. The volume that contains the beginning of the file to be restored should be placed in the device.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
|
<dd>The objects are restored from the volumes placed in the device specified for the <b>Device (DEV)</b> parameter. For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command.
|
|
<p>
|
|
<b>Note: </b>This value cannot be specified when using an optical media library device.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 75 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the identifiers of one or more volumes in the order in which they are placed in a device and used to restore the data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.SEQNBR"></a>
|
|
<h3>Sequence number (SEQNBR)</h3>
|
|
<p>Specifies the sequence number that is used for the restore operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SEARCH</u></b></dt>
|
|
<dd>The volume placed in a device is searched for a data file containing the saved system information objects. When a match is found, the system information objects are restored.
|
|
</dd>
|
|
<dt><b><i>1-16777215</i></b></dt>
|
|
<dd>Specify the sequence number of the file to be used for the restore operation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.ENDOPT"></a>
|
|
<h3>End of media option (ENDOPT)</h3>
|
|
<p>Specifies the operation that is automatically done on the tape or optical volume after the restore operation ends. If more than one volume is used, this parameter applies only to the last volume used; all other volumes are unloaded when the end of the volume is reached.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified for the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REWIND</u></b></dt>
|
|
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LEAVE</b></dt>
|
|
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.SAVF"></a>
|
|
<h3>Save file (SAVF)</h3>
|
|
<p>Specifies the save file used to restore the data.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for this parameter if *SAVF is specified for the <b>Device (DEV)</b> parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Save file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of save file to be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the save file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.OPTFILE"></a>
|
|
<h3>Optical file (OPTFILE)</h3>
|
|
<p>Specifies the path name of the optical file that is used for the restore operation, beginning with the root directory of the volume.
|
|
</p>
|
|
<p>For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The system searches the root directory of the optical volume for the default name generated by the corresponding save operation.
|
|
</dd>
|
|
<dt><b><i>'optical-directory-path-name/*'</i></b></dt>
|
|
<dd>The system searches the specified directory of the optical volume for the default name generated by the corresponding save operation.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>'optical-file-path-name'</i></b></dt>
|
|
<dd>Specify the path name of the optical file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether a listing that shows information about the status of the objects is created and directed to an output file. The listing shows the restore information and shows all objects restored, not restored, and excluded. Information about each object's security is listed for the restored objects.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No output is created.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p>
|
|
<b>Note: </b>You must specify a database file name for the OUTFILE parameter when OUTPUT(*OUTFILE) is specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the database file to which the information is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter. If the file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses QASRRSTO in QSYS with the format name QSRRST as a model.
|
|
</p>
|
|
<p><b>Qualifier 1: File to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the database file to which output from the command is directed. If this file does not exist, it is created in the specified library.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTSYSINF.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter.
|
|
</p>
|
|
<p><b>Element 1: Member to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
|
|
<p>If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Replace or add records</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The existing records in the specified database file member are replaced by the new records.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The new records are added to the existing information in the specified database file member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTSYSINF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: System Information Restored from TAP01</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTSYSINF DEV(TAP01)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the system information from the tape put on the TAP01 tape drive.
|
|
</p>
|
|
<p><b>Example 2: System Information Restored from SAVF and Printed Output Generated</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTSYSINF DEV(*SAVF) SAVF(QGPL/SAVF) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the system information from the save file named SAVF in library QGPL. Information about what was restored will be written to a spooled file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTSYSINF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF38A8</b></dt>
|
|
<dd>RSTSYSINF completed. One or more objects not restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTSYSINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|