1438 lines
65 KiB
HTML
1438 lines
65 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 Object (RSTOBJ)</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="RSTOBJ.Top_Of_Page"></a>
|
||
|
|
<h2>Restore Object (RSTOBJ)</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="#RSTOBJ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RSTOBJ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RSTOBJ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RSTOBJ"></a>
|
||
|
|
<p>The Restore Object (RSTOBJ) command restores to the system a single object or a group of objects in a single library that were saved on a tape or optical volume, or in a save file using a single command. Objects to be restored could have been saved by the Save Object (SAVOBJ), Save Changed Objects (SAVCHGOBJ) or Save Library (SAVLIB) command. The RSTOBJ command restores the object description and contents of each object specified in the command.
|
||
|
|
</p>
|
||
|
|
<p>For job queues, user-defined message queues, logical files, and user queues, only the object descriptions are restored; the contents of those objects are not restored. However, logical file access paths can be saved by a save command with ACCPTH(*YES) specified; if this is done, the access paths can be restored. More information on restoring access paths is in the Database information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter. The contents of spooled files on output queues can be restored, if they were saved, by specifying *NEW for the <b>Spooled file data (SPLFDTA)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>The command can be used to restore the objects even if the object storage was freed when the objects were saved, or if the objects were deleted after they were saved. If the storage was not freed as part of a save operation, each object is restored in the same area of storage that it previously occupied. If the version of the object being restored is larger than the version in the system (for example, data records that were deleted from the system still exist in the saved version of a file), the additional storage needed for the object is acquired. If the saved version of the object is smaller (for example, data records that are added to the system), the space that was acquired for the object remains assigned to that object and available for use by that object.
|
||
|
|
</p>
|
||
|
|
<p>If logical file access paths were saved (ACCPTH(*YES) was specified when the objects were saved), the access paths are restored if (1) all based-on physical files are also being restored by the same restore command, (2) the logical file is also being restored by the same restore command, or the logical file already exists on the system (the same file exists, not a re-created version), and (3) MAINT(*IMMED or *DLY) is in effect for the logical file if it still exists on the system.
|
||
|
|
</p>
|
||
|
|
<p>If the storage was freed, the system finds the storage space needed to store the contents (only the data portion) of each file, module, program, service program, journal receiver, and Structured Query Language (SQL) package. If the objects do not exist on the system because they were deleted or they are being restored in a different system, the system must find the storage to store everything (the description and the data portion) about each unknown object.
|
||
|
|
</p>
|
||
|
|
<p>The user profile of the system default owner (QDFTOWN) becomes the default owner of objects restored in the system whose owner is not known to the system.
|
||
|
|
</p>
|
||
|
|
<p>If an object is being restored over an existing object on the system, the object auditing value of the existing object is kept. If the object is being restored as new to the system, the object auditing value is restored from the media.
|
||
|
|
</p>
|
||
|
|
<p><b>ATTENTION:</b> Do not use this command to restore licensed programs into library QSYS. Unpredictable results can occur.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>This command is shipped with no public authority (*EXCLUDE).
|
||
|
|
</li>
|
||
|
|
<li>You must have use (*USE) authority for the Create Save File (CRTSAVF) command when restoring a save file that does not currently exist on the system.
|
||
|
|
</li>
|
||
|
|
<li>When saving or restoring to an existing database file using the OUTFILE parameter, you must have execute (*EXECUTE) authority to the library where the output database file is located.
|
||
|
|
</li>
|
||
|
|
<li>With the exception of overrides for the restore listing file and database files specified for the OUTFILE parameter, this command ignores all file overrides that are currently in effect for the job.
|
||
|
|
</li>
|
||
|
|
<li>You must have save system (SAVSYS) special authority, or all of the following object authorities:
|
||
|
|
<ul>
|
||
|
|
<li>Add (*ADD) and execute (*EXECUTE) authorities for the specified library and save file library.
|
||
|
|
</li>
|
||
|
|
<li>Object existence (*OBJEXIST) authority for, or be the owner of, each object specified if the object already exists in the library on the system. *OBJEXIST and use (*USE) authorities are required for message queue objects. If the object does not already exist in the library on the system, you must have *ADD authority for the user profiles that own each object being restored. For spooled file data, *OBJEXIST authority is required for the output queue to which it is restored.
|
||
|
|
</li>
|
||
|
|
<li>If VOL(*SAVVOL) is specified, *USE authority to the saved-from library.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The RSTOBJ command does not restore the library's data dictionary or its associated database files. To do this, the RSTLIB command must be used.
|
||
|
|
</li>
|
||
|
|
<li>You must have *USE authority for the save file to restore from the save file. In addition, the user must have *USE authority for the device description when restoring from a tape or optical device.
|
||
|
|
</li>
|
||
|
|
<li>When using a media definition, you must have *USE authority to the media definition and *EXECUTE authority to the media definition library.
|
||
|
|
</li>
|
||
|
|
<li>If this command is used to restore an OPM program, the copy of that program that is currently in the system must not be running while the program is being restored. If this occurs, the running program may fail or behave unpredictably.
|
||
|
|
</li>
|
||
|
|
<li>Objects saved by separate commands must also be restored by separate commands. If a single command is used, some of the objects are not restored.
|
||
|
|
</li>
|
||
|
|
<li>If the user domain object user space (*USRSPC), user index (*USRIDX), or user queue (*USRQ) is restored to a library that is not permitted in the system value QALWUSRDMN (allow user domain objects in libraries), the object is converted to a system domain object.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RSTOBJ.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="#RSTOBJ.OBJ"><b>OBJ</b></a></td>
|
||
|
|
<td valign="top">Objects</td>
|
||
|
|
<td valign="top">Single values: *ALL<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="#RSTOBJ.SAVLIB"><b>SAVLIB</b></a></td>
|
||
|
|
<td valign="top">Saved library</td>
|
||
|
|
<td valign="top">Single values: *ANY<br>Other values (up to 300 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Single values: *SAVF, *MEDDFN<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.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 74 repetitions): *ALRTBL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *DTAARA, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LOCALE, *MEDDFN, *MENU, *MGTCOL, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *NWSCFG, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *TIMZON, *USRIDX, *USRQ, *USRSPC, *VLDL, *WSCST</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.VOL"><b>VOL</b></a></td>
|
||
|
|
<td valign="top">Volume identifier</td>
|
||
|
|
<td valign="top">Single values: <b><u>*MOUNTED</u></b>, *SAVVOL<br>Other values (up to 75 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.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, Positional 6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.LABEL"><b>LABEL</b></a></td>
|
||
|
|
<td valign="top">Label</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAVLIB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.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="#RSTOBJ.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="#RSTOBJ.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *NEW, *OLD, *FREE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RSTOBJ.FILEMBR"><b>FILEMBR</b></a></td>
|
||
|
|
<td valign="top">File member</td>
|
||
|
|
<td valign="top">Values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: File</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Member</td>
|
||
|
|
<td valign="top">
|
||
|
|
Single values: <b><u>*ALL</u></b>, *NONE<br>Other values (up to 50 repetitions): <i>Generic name, name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.MBROPT"><b>MBROPT</b></a></td>
|
||
|
|
<td valign="top">Data base member option</td>
|
||
|
|
<td valign="top"><b><u>*MATCH</u></b>, *ALL, *NEW, *OLD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.SPLFDTA"><b>SPLFDTA</b></a></td>
|
||
|
|
<td valign="top">Spooled file data</td>
|
||
|
|
<td valign="top"><b><u>*NEW</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.SAVDATE"><b>SAVDATE</b></a></td>
|
||
|
|
<td valign="top">Date when saved</td>
|
||
|
|
<td valign="top"><i>Date</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.SAVTIME"><b>SAVTIME</b></a></td>
|
||
|
|
<td valign="top">Time when saved</td>
|
||
|
|
<td valign="top"><i>Time</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.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 4 repetitions): *AUTL, *FILELVL, *OWNER, *PGP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RSTOBJ.FRCOBJCVN"><b>FRCOBJCVN</b></a></td>
|
||
|
|
<td valign="top">Force object conversion</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *NO<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Convert during restore</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*YES</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Objects to convert</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*RQD</u></b>, *ALL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.RSTLIB"><b>RSTLIB</b></a></td>
|
||
|
|
<td valign="top">Restore to library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SAVLIB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.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="#RSTOBJ.MEDDFN"><b>MEDDFN</b></a></td>
|
||
|
|
<td valign="top">Media definition</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Media definition</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="#RSTOBJ.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="#RSTOBJ.RSTASPDEV"><b>RSTASPDEV</b></a></td>
|
||
|
|
<td valign="top">Restore to ASP device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SAVASPDEV</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.RSTASP"><b>RSTASP</b></a></td>
|
||
|
|
<td valign="top">Restore to ASP number</td>
|
||
|
|
<td valign="top">1-32, <b><u>*SAVASP</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RSTOBJ.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="#RSTOBJ.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>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.INFTYPE"><b>INFTYPE</b></a></td>
|
||
|
|
<td valign="top">Type of output information</td>
|
||
|
|
<td valign="top"><b><u>*OBJ</u></b>, *MBR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTOBJ.OMITLIB"><b>OMITLIB</b></a></td>
|
||
|
|
<td valign="top">Libraries to omit</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#RSTOBJ.OMITOBJ"><b>OMITOBJ</b></a></td>
|
||
|
|
<td valign="top">Objects to omit</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Object type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RSTOBJ.OBJ"></a>
|
||
|
|
<h3>Objects (OBJ)</h3>
|
||
|
|
<p>Specifies the names of one or more objects to restore. The objects you specify will be restored from the first file that meets the search value and contains any of the objects. If a tape contains multiple files for the same library, you may need to specify the tape file sequence number to ensure that all of the correct objects are restored.
|
||
|
|
</p>
|
||
|
|
<p>If the file does not contain all of the objects you specify, diagnostic messages will be issued for the objects not found. The completion message will contain a count of objects restored and objects not restored.
|
||
|
|
</p>
|
||
|
|
<p>If the <b>Object types (OBJTYPE)</b> parameter is not specified when the command is run, all the object types listed in the description of that parameter are restored, if they are in the specified library on the media or in the save file, and if they have the specified names.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the objects saved from the specified library are restored, depending on the values specified for the <b>Object types (OBJTYPE)</b> and <b>Option (OPTION)</b> parameters.
|
||
|
|
</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. 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.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.SAVLIB"></a>
|
||
|
|
<h3>Saved library (SAVLIB)</h3>
|
||
|
|
<p>Specifies the libraries that contained the saved objects. If *SAVLIB is specified or defaulted for the <b>Restore to library (RSTLIB)</b> parameter, this is also the name of the library to which the objects are restored.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>If you specify more than one library, or a single value, or a generic library value:
|
||
|
|
<ul>
|
||
|
|
<li>The <b>Device (DEV)</b> parameter must not specify *SAVF.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Restore to library (RSTLIB)</b> parameter must specify *SAVLIB.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Label (LABEL)</b> parameter must specify *SAVLIB.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Optical file (OPTFILE)</b> parameter must specify * or end with /*.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The tape or optical file that you select to restore may contain a library that does not match the value that you specify for this parameter. This parameter is used to determine the default LABEL value for a tape file and the default OPTFILE value for an optical file, but the restore operation does not verify that this parameter matches the saved library.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>Restores objects from the first version of all saved libraries found on the tape beginning with the sequence number specified for the <b>Sequence number (SEQNBR)</b> parameter, or restores objects from all saved libraries found on the optical media in the directory specified for the OPTFILE parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries to be restored.
|
||
|
|
<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 the name of the library to restore. The name of the library being restored must be the same as the name that was used when the library was saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDDFN</b></dt>
|
||
|
|
<dd>The restore operation is done using the devices and media identified in the media definition specified for the <b>Media definition (MEDDFN)</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. To use more than one device in parallel, a media definition must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.OBJTYPE"></a>
|
||
|
|
<h3>Object types (OBJTYPE)</h3>
|
||
|
|
<p>Specifies the types of system objects that are restored.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All object types that are specified by name and were saved from the specified library are restored. If *ALL is also specified for the <b>Objects (OBJ)</b> parameter, all objects saved for that library are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the value for each of the types of objects to be restored, such as command (*CMD), file (*FILE), or program (*PGM).
|
||
|
|
<p>To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>*CFGL object types can be restored using the Restore Object (RSTOBJ) command only from objects saved on releases prior to V2R2M0. *CFGL object types saved on V2R2M0 and newer releases are restored using the Restore Configuration (RSTCFG) command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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>Note: </b>The version of the objects restored is the first version found in the specified location, unless a specific version is identified by the <b>Date when saved (SAVDATE)</b> and <b>Time when saved (SAVTIME)</b> parameters.
|
||
|
|
</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>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SAVVOL</b></dt>
|
||
|
|
<dd>The system, by using the save or restore history information, determines which volumes contain the most recently saved version of the objects.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If this is a restore from an optical device, only the first 6 characters of the volume name are available. If the volume name of the optical media exceeds 6 characters, the volume may not be found. You should specify the complete volume or file name on the command instead of using VOL(*SAVVOL) when the name of the optical media exceeds 6 characters.
|
||
|
|
</p>
|
||
|
|
<p>When *SAVVOL is specified, the following operational characteristics and restrictions apply:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If the characteristics of the device specified in the DEV parameter do not match the device and location of the most recently saved version of the library, an error message is sent to the <b>user</b>, and the function is ended.
|
||
|
|
</li>
|
||
|
|
<li>If the wrong volume is placed in a device in the location specified by the command, a message is sent to the <b>system operator</b> that identifies the first volume that must be placed in the device before the objects can be restored.
|
||
|
|
</li>
|
||
|
|
<li>When OBJ(*ALL) and OBJTYPE(*ALL) is specified, the objects are considered in the order they would appear in a display produced by the Display Library (DSPLIB) command. The object names and types specified in the RSTOBJ command are used to determine which file of saved objects is used in the restore operation. One file is produced for each SAVLIB or SAVOBJ command run. The file chosen is the one in which the first considered object was last saved. Objects that were not saved in the file chosen to be processed, or that were more recently saved, are not restored; an error message is sent to the user for each unrestored object.
|
||
|
|
</li>
|
||
|
|
<li>If *SAVVOL is specified, the SAVDATE and SAVTIME parameters cannot be specified.
|
||
|
|
</li>
|
||
|
|
<li>If *SAVVOL is specified and the RSTLIB value is equal to the SAVLIB value, OPTION(*NEW) cannot be specified.
|
||
|
|
</li>
|
||
|
|
<li>If *SAVVOL is specified, SEQNBR(*SEARCH) and LABEL(*SAVLIB) must be specified.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies, when tape is used, which sequence number is used for the restore operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SEARCH</u></b></dt>
|
||
|
|
<dd>The volume in the device is searched for a data file with an identifier that matches the FROMLABEL parameter value; when a match is found, the object is restored. If the last operation on the device specified *LEAVE for the <b>End of tape option (ENDOPT)</b> parameter, indicating that the tape is positioned at the location where the last operation ended, the file search starts with the first data file beyond the current tape position. If *LEAVE was not used for the <b>End of tape option (ENDOPT)</b> parameter of the last operation, or if the tape was manually rewound since the operation, the search starts with the first data file on the volume.
|
||
|
|
</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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.LABEL"></a>
|
||
|
|
<h3>Label (LABEL)</h3>
|
||
|
|
<p>Specifies the name that identifies the data file to be used for the restore operation. This label must have been specified on the save command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVLIB</u></b></dt>
|
||
|
|
<dd>The file label is the name specified for the <b>Saved library (SAVLIB)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the data file identifier of the data file used for the restore operation. A maximum of 17 characters can be used. This option is valid only for a single-library restore.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies how to handle restoring each object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All the objects in the saved library are restored to the library. Objects in the saved library replace the current versions in the system library. Objects not having a current version are added to the system library. Objects presently in the library, but not on the media, remain in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>Only the objects in the saved library that do not exist in the current version of the system library are added to the library. Only objects not known to the system library are restored; known objects are not restored. This option restores objects that were deleted after they were saved or that are new to this library. If any saved objects have a version already in the system library, they are not restored, and an informational message is sent for each one, but the restore operation continues.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>Only the objects in the library having a saved version are restored; that is, the version of each object currently in the library is replaced by the saved version. Only objects known to the library are restored. If any saved objects are no longer part of the online version of the library, they are not added to the library; an informational message is sent for each one, but the restore continues.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FREE</b></dt>
|
||
|
|
<dd>The saved objects are restored only if they exist in the system library with their space freed. The saved version of each object is restored on the system in its previously freed space. This option restores objects that had their space freed when they were saved. If any saved objects are no longer part of the current version of the library, or if the space is not free for any object, the object is not restored and an informational message is sent for each one. The restore operation continues, and all of the freed objects are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.FILEMBR"></a>
|
||
|
|
<h3>File member (FILEMBR)</h3>
|
||
|
|
<p>Specifies the database file members to restore. This parameter is made up of two parts: the file name and the member name. This parameter cannot be specified if *MATCH is specified for the <b>Data base member option (MBROPT)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>Each database file specified here must also be specified for the <b>Objects (OBJ)</b> parameter, by a specific name, a generic name, or *ALL. The <b>Object types (OBJTYPE)</b> parameter must either be *ALL or include *FILE. Generic names are not valid for the database file name but are allowed for the member name. Duplicate file names are not allowed.
|
||
|
|
</p>
|
||
|
|
<p>There may be up to 50 of the file/member element list combinations specified for this parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: File</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>The list of member name values that follows this value applies to all files indicated on the OBJ parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the database file from which the listed members are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Member</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All members are restored from the specified file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No members are restored from the specified file. Only the file description is restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 50 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the members to be restored from the specified file. 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 member name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member to be restored from the specified file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.MBROPT"></a>
|
||
|
|
<h3>Data base member option (MBROPT)</h3>
|
||
|
|
<p>Specifies, for database files that exist on the system, which members are restored. If *MATCH is used, the member list in the saved file must match, member for member, the current version on the system. All members are restored for files that do not exist, if the file is restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MATCH</u></b></dt>
|
||
|
|
<dd>The saved members are restored if the lists of the members where they exist match, member for member, the lists of the current system version. MBROPT(*MATCH) is not valid when *ALL is specified for the <b>Allow object differences (ALWOBJDIF)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All members in the saved file are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>Only new members (members not known to the system) are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>Only members already known to the system are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.SPLFDTA"></a>
|
||
|
|
<h3>Spooled file data (SPLFDTA)</h3>
|
||
|
|
<p>Specifies whether to restore spooled file data and attributes.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NEW</u></b></dt>
|
||
|
|
<dd>For each output queue that is restored, spooled file data that was saved with the output queue is restored, if it does not already exist on the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No spooled file data is restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.SAVDATE"></a>
|
||
|
|
<h3>Date when saved (SAVDATE)</h3>
|
||
|
|
<p>Specifies the date when the objects were saved. If the most recently saved version is not the one being restored, or if multiple saved versions exist on the media volume, specify the date that indicates which version of the objects to restore. If a volume identifier or *MOUNTED is specified for the <b>Volume identifier (VOL)</b> parameter, but SAVDATE is not, the version of the objects that is restored is the first version found on the volume. This parameter is valid only if a volume identifier or *MOUNTED is specified for the VOL parameter or if a save file is specified for the <b>Save file (SAVF)</b> parameter. This parameter is ignored when the <b>Sequence number (SEQNBR)</b> parameter is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date that the library to be restored was saved. The date must be entered in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.SAVTIME"></a>
|
||
|
|
<h3>Time when saved (SAVTIME)</h3>
|
||
|
|
<p>Specifies the time at which the objects were saved.
|
||
|
|
</p>
|
||
|
|
<p>If a volume identifier or *MOUNTED is specified for the <b>Volume identifier (VOL)</b> parameter, but this parameter is not specified, the version of the objects to be restored is the first version found on the volume. This parameter is valid only if the <b>Date when saved (SAVDATE)</b> parameter is also specified.
|
||
|
|
</p>
|
||
|
|
<p>This parameter is ignored when a number is specified for the <b>Sequence number (SEQNBR)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the time that the library to be restored was saved. The time can be specified with or without a time separator:
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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>File level id: The creation date and time of the database file on the system does not match the creation date and time of the file that was saved.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
<li>Member level id: The creation date and time of the database file member on the system does not match the creation date and time of the member that was saved.
|
||
|
|
</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. File level id and member level id differences are handled differently than the *FILELVL value. If there is a file level difference and *ALL is specified for the <b>Data base member option (MBROPT)</b> parameter, the existing version of the file is renamed and the saved version of the file is restored. If there is a member level difference, the existing version of the member is renamed and the saved version of the member is restored. This value will restore the saved data, but the result may not be correct. You will need to choose whether the restored data or the renamed data is correct, and you will need to make the necessary corrections to the database. For other differences, see the description of each individual value to determine how differences are handled.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 4 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>*FILELVL</b></dt>
|
||
|
|
<dd>File level id and member level id differences are allowed. An attempt will be made to restore existing physical files even though the physical file on the save media may have a different file level id or member level id than the physical file on the system. The physical file data will only be restored for those physical files whose format level identifiers on the save media match the format level identifiers of the corresponding physical file on the system.
|
||
|
|
<p>If this value is not specified, file level id and member level id differences are not allowed. If an object already exists on the system with a different file level id or member level id than the saved object, the object is not restored.
|
||
|
|
</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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.FRCOBJCVN"></a>
|
||
|
|
<h3>Force object conversion (FRCOBJCVN)</h3>
|
||
|
|
<p>Specifies whether to convert user objects to the format required for use in the current version of the operating system when the objects are restored.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This parameter applies only to user objects of the *MODULE, *PGM, *SRVPGM, and *SQLPKG object types.
|
||
|
|
</li>
|
||
|
|
<li>An object must have creation data (either observable or unobservable) to be converted.
|
||
|
|
</li>
|
||
|
|
<li>If an object needs to be converted (because it is formatted for an earlier version of the operating system), but is not converted during this restore operation, the object is automatically converted the first time it is used.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
|
<dd>The objects are converted based on the value of the QFRCCVNRST system value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The objects are not converted during the restore operation.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If FRCOBJCVN(*NO) is specified, then the QFRCCVNRST system value must have a value of either "0" or "1".
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Convert during restore</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The objects are converted during the restore operation.
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>If FRCOBJCVN(*YES *RQD) is specified, then the QFRCCVNRST system value must have a value of "0", "1", or "2". FRCOBJCVN(*YES *RQD) will override a QFRCCVNRST value of "0" or "1". If FRCOBJCVN(*YES *ALL) is specfied, then QFRCCVNRST can have any valid value and FRCOBJCVN(*YES *ALL) overrides the QFRCCVNRST system value.
|
||
|
|
</li>
|
||
|
|
<li>Specifying this value increases the time of the restore operation, but avoids the need to convert the objects when they are first used.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Objects to convert</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RQD</u></b></dt>
|
||
|
|
<dd>The objects are converted only if they require conversion to be used by the current operating system. If the objects do not have all creation data (either observable or unobservable), the objects cannot be converted and will not be restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All objects are converted regardless of their current format, including objects already in the current format. However, if the objects do not have all creation data (either observable or unobservable), the objects cannot be converted and will not be restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.RSTLIB"></a>
|
||
|
|
<h3>Restore to library (RSTLIB)</h3>
|
||
|
|
<p>Specifies whether the objects are restored to a different library or to the same library where they were saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVLIB</u></b></dt>
|
||
|
|
<dd>The objects are restored to the same library from which they were saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to which the saved objects are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.MEDDFN"></a>
|
||
|
|
<h3>Media definition (MEDDFN)</h3>
|
||
|
|
<p>Specifies the media definition (*MEDDFN) object that identifies the devices and media used to restore the data. For information about creating and using a media definition, see the Backup and Recovery book, SC41-5304, and the Create Media Definition API in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
<p>If a media definition is specified, the VOL, SEQNBR, SAVF, and OPTFILE parameters cannot be specified. The volume identifiers and sequence numbers are specified in the media definition.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Media definition</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the media definition 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 searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
||
|
|
</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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.RSTASPDEV"></a>
|
||
|
|
<h3>Restore to ASP device (RSTASPDEV)</h3>
|
||
|
|
<p>Specifies the auxiliary storage pool (ASP) device to which the data is to be restored.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You can specify either the RSTASPDEV parameter or the RSTASP parameter, but not both.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVASPDEV</u></b></dt>
|
||
|
|
<dd>The data is restored to the same ASP from which it was saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the ASP device to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.RSTASP"></a>
|
||
|
|
<h3>Restore to ASP number (RSTASP)</h3>
|
||
|
|
<p>Specifies whether objects are restored to the auxiliary storage pool (ASP) from which they were saved or to the system ASP (ASP number 1) or to a basic user ASP (ASP numbers 2 through 32).
|
||
|
|
</p>
|
||
|
|
<p>Some objects cannot be restored to user ASPs. More information about object types which can be restored to user ASPs is in the Backup and Recovery book, SC41-5304. If the library exists in, or is being restored to the system ASP, journals, journal receivers, and save files can be restored to basic user ASPs. All other object types will be restored to the ASP of the library.
|
||
|
|
</p>
|
||
|
|
<p><b>ATTENTION: System or product libraries (libraries that begin with a Q or #) must not be created in or restored to a user ASP. Doing so can cause unpredictable results.</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVASP</u></b></dt>
|
||
|
|
<dd>The objects are restored to the ASP from which they were saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specifies the ASP number. When the specified ASP is 1, the specified objects are restored to the system ASP, and when the specified ASP is 2 through 32, the objects are restored to the basic user ASP specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.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="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.INFTYPE"></a>
|
||
|
|
<h3>Type of output information (INFTYPE)</h3>
|
||
|
|
<p>Specifies the type of information which is printed or directed to the database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*OBJ</u></b></dt>
|
||
|
|
<dd>The list contains an entry for each object requested to be restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MBR</b></dt>
|
||
|
|
<dd>The list contains an entry for each object, database file member, and spooled file requested to be restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.OMITLIB"></a>
|
||
|
|
<h3>Libraries to omit (OMITLIB)</h3>
|
||
|
|
<p>Specifies a list of libraries to be excluded from the restore operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No libraries are excluded from the restore operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries to be excluded.
|
||
|
|
<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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be excluded from the restore operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTOBJ.OMITOBJ"></a>
|
||
|
|
<h3>Objects to omit (OMITOBJ)</h3>
|
||
|
|
<p>Specifies the objects to be excluded from the operation. Up to 300 objects or generic object values can be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Object</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 1: Object</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No objects are excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All objects of the specified object type are excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the objects to be excluded.
|
||
|
|
<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 the name of the object to be excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>The specified objects are excluded from all libraries that are part of the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries that contain objects to be excluded.
|
||
|
|
<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 the name of the library that contains the object to be excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Object type</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All object types are excluded from the operation, depending on the value specified for the object name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the object type of the objects to be excluded from the operation.
|
||
|
|
<p>To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTOBJ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Restoring Most Recently Saved Version</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTOBJ OBJ(PAYROLL) SAVLIB(LIBX) DEV(TAP01)
|
||
|
|
OBJTYPE(*PGM) VOL(*SAVVOL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command restores to LIBX the program named PAYROLL that was saved from LIBX. The tape drive named TAP01 is used to restore the most recently saved version of the program.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Specifying Save Date and Time</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTOBJ OBJ(PAY*) SAVLIB(LIBX) DEV(OPT01) VOL(ABCD)
|
||
|
|
OPTION(*OLD) SAVDATE(102202)
|
||
|
|
SAVTIME(143000) RSTLIB(LIBY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>All objects whose names start with PAY and that were saved from the library named LIBX on optical volume ABCD at 14:30:00 on 10/22/02 are restored to LIBY. Volume ABCD must be put on the optical device named OPT01. Because OPTION(*OLD) is specified, the only objects restored are those having the same object name and type both in LIBY on the system and in LIBX on the optical volume.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Adding a New Program to the QGPL Library</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTOBJ OBJ(NEWPROG) SAVLIB(QGPL) DEV(OPT01) OBJTYPE(*PGM)
|
||
|
|
VOL(PGMS) OPTION(*NEW) ALWOBJDIF(*AUTL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>A new program named NEWPROG is added to the general purpose library, QGPL. It is restored from a volume labeled PGMS that is inserted in the optical device named OPT01. If the object was saved on a different system and was linked to an authorization list, it will be linked to the authorization list with the same name on this system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Printing An Output List</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTOBJ OBJ(*ALL) SAVLIB(LIB) DEV(TAP01) OBJTYPE(*PGM)
|
||
|
|
VOL(SVOL) SEQNBR(2) SAVDATE(082392)
|
||
|
|
SAVTIME(143000) OUTPUT(*PRINT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>All programs that were saved from the library named LIB that exist in the saved version on the tape volume named SVOL, sequence number 2, saved at 14:30:00 on 08/23/92, are restored to the library named LIB. An output list of all objects restored as well as objects not restored is provided.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Restoring Journal Receivers</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTOBJ OBJ(*ALL) SAVLIB(BACKUP) DEV(*SAVF)
|
||
|
|
OBJTYPE(*JRNRCV) SAVF(SAVEJ) RSTASP(3)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>All journal receivers that were saved from the library named BACKUP into the save file named SAVEJ are restored to the library named BACKUP. The journal receivers are restored to basic user ASP 3 (unless they already exist in the library named BACKUP and are in a different ASP or ASP 3 contains a library).
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTOBJ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF370C</b></dt>
|
||
|
|
<dd>Not authorized to ALWOBJDIF parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3705</b></dt>
|
||
|
|
<dd>&2 &1 in &3 not journaled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3706</b></dt>
|
||
|
|
<dd>&2 &1 not restored to library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3707</b></dt>
|
||
|
|
<dd>Save file &1 in &2 contains no data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3709</b></dt>
|
||
|
|
<dd>Tape devices do not support same densities.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3727</b></dt>
|
||
|
|
<dd>Duplicate device &1 specified on device name list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3728</b></dt>
|
||
|
|
<dd>Device &1 specified with other devices.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3730</b></dt>
|
||
|
|
<dd>Not authorized to &2 &1 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3731</b></dt>
|
||
|
|
<dd>Cannot use &2 &1 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3733</b></dt>
|
||
|
|
<dd>&2 &1 in &3 previously damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3738</b></dt>
|
||
|
|
<dd>Device &1 used for save or restore is damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3739</b></dt>
|
||
|
|
<dd>Database file &1 member in &3 damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF374C</b></dt>
|
||
|
|
<dd>No objects restored to ASP &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3743</b></dt>
|
||
|
|
<dd>File cannot be restored, displayed, or listed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3748</b></dt>
|
||
|
|
<dd>Object information for library &1 damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3767</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3768</b></dt>
|
||
|
|
<dd>Device &1 not valid for command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3769</b></dt>
|
||
|
|
<dd>File found on media not save/restore file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3770</b></dt>
|
||
|
|
<dd>No objects saved or restored for library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3773</b></dt>
|
||
|
|
<dd>&1 objects restored. &2 not restored to &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3780</b></dt>
|
||
|
|
<dd>Specified file for library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3781</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3782</b></dt>
|
||
|
|
<dd>File &1 in &2 not a save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3783</b></dt>
|
||
|
|
<dd>Cannot determine VOL(*SAVVOL) location. No objects restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3784</b></dt>
|
||
|
|
<dd>Restore device specified in the DEV parameter does not match VOL(*SAVVOL) device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3791</b></dt>
|
||
|
|
<dd>While processing &2 &1 in &3, encountered end of file &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3793</b></dt>
|
||
|
|
<dd>Machine or ASP storage limit reached.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3794</b></dt>
|
||
|
|
<dd>Save or restore operation ended unsuccessfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3796</b></dt>
|
||
|
|
<dd>Storage limit exceeded for user profile &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF37A5</b></dt>
|
||
|
|
<dd>RSTASP &1 is not online.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3805</b></dt>
|
||
|
|
<dd>Objects from save file &1 in &2 not restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3807</b></dt>
|
||
|
|
<dd>Data decompression error for save file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3812</b></dt>
|
||
|
|
<dd>Save file &1 in &2 in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF384F</b></dt>
|
||
|
|
<dd>&2 &1 not restored to library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3867</b></dt>
|
||
|
|
<dd>Contents of FILEMBR parameter not correct.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3868</b></dt>
|
||
|
|
<dd>FILEMBR specified but OBJTYPE must be *ALL or *FILE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3871</b></dt>
|
||
|
|
<dd>No objects saved or restored; &3 objects not included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3872</b></dt>
|
||
|
|
<dd>&1 objects restored. &2 not restored to &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF38A2</b></dt>
|
||
|
|
<dd>ASP device &1 not correct.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF38A6</b></dt>
|
||
|
|
<dd>Only one library allowed with specified parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5729</b></dt>
|
||
|
|
<dd>Not able to allocate object &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9809</b></dt>
|
||
|
|
<dd>Library &1 cannot be accessed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9812</b></dt>
|
||
|
|
<dd>File &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9814</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9820</b></dt>
|
||
|
|
<dd>Not authorized to use library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9822</b></dt>
|
||
|
|
<dd>Not authorized to file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9825</b></dt>
|
||
|
|
<dd>Not authorized to device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9829</b></dt>
|
||
|
|
<dd>Auxiliary storage pool &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFB8ED</b></dt>
|
||
|
|
<dd>Device description &1 not correct for operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>OPT1498</b></dt>
|
||
|
|
<dd>Volume name list exhausted on device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>OPT1502</b></dt>
|
||
|
|
<dd>Attempted to process past the end of a multi-volume set.
|
||
|
|
</dd>
|
||
|
|
<dt><b>OPT1605</b></dt>
|
||
|
|
<dd>Media or device error occurred.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTOBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|