339 lines
14 KiB
HTML
339 lines
14 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>Start Retrieve using OnDemand (STRRTVRDAR)</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="STRRTVRDAR.Top_Of_Page"></a>
|
||
|
|
<h2>Start Retrieve using OnDemand (STRRTVRDAR)</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="#STRRTVRDAR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRRTVRDAR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRRTVRDAR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRRTVRDAR"></a>
|
||
|
|
<p>The Start Retrieve using OnDemand (STRRTVRDAR) command retrieves a single object in a library that was previously archived. It restores the object description and contents of the object to the library specified on the command. The types of objects that can be retrieved by this command are listed on the <b>Object type (OBJTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRRTVRDAR.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="#STRRTVRDAR.OBJ"><b>OBJ</b></a></td>
|
||
|
|
<td valign="top">Object</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Archived library</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.OBJTYPE"><b>OBJTYPE</b></a></td>
|
||
|
|
<td valign="top">Object type</td>
|
||
|
|
<td valign="top"><b><u>*ANY</u></b>, *ALRTBL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CRQD, *CSI, *CSPMAP, *CSPTBL, *DTAARA, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FNTRSC, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *MENU, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *USRIDX, *USRQ, *USRSPC, *WSCST</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.GEN"><b>GEN</b></a></td>
|
||
|
|
<td valign="top">Generation</td>
|
||
|
|
<td valign="top">-98-0, <b><u>*CURRENT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*NEW</u></b>, *OLD, *FREE, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.FILEMBR"><b>FILEMBR</b></a></td>
|
||
|
|
<td valign="top">File member</td>
|
||
|
|
<td valign="top">Values (up to 20 repetitions): <i>Generic name, name</i>, <b><u>*ALL</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.MBROPT"><b>MBROPT</b></a></td>
|
||
|
|
<td valign="top">Database 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="#STRRTVRDAR.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
|
||
|
|
<td valign="top">Allow object differences</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.RTVLIB"><b>RTVLIB</b></a></td>
|
||
|
|
<td valign="top">Retrieve to library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.RTVASP"><b>RTVASP</b></a></td>
|
||
|
|
<td valign="top">Retrieve to ASP</td>
|
||
|
|
<td valign="top">1-16, <b><u>*ARCASP</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRTVRDAR.DLTSAVF"><b>DLTSAVF</b></a></td>
|
||
|
|
<td valign="top">Delete save file</td>
|
||
|
|
<td valign="top"><b><u>*OMC</u></b>, *IMMED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRRTVRDAR.OBJ"></a>
|
||
|
|
<h3>Object (OBJ)</h3>
|
||
|
|
<p>Specifies the name of the object to retrieve. The object you specify will be retrieved from the archive that contains the specified generation.
|
||
|
|
</p>
|
||
|
|
<p>If the generation of the object does not exist in the archives, a diagnostic message is issued.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.LIB"></a>
|
||
|
|
<h3>Archived library (LIB)</h3>
|
||
|
|
<p>Specifies the name of the library that contains the archived object. If the <b>Retrieve to library (RTVLIB)</b> parameter is not specified, this is also the name of the library to which the object is retrieved. Specify the name of the library.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.OBJTYPE"></a>
|
||
|
|
<h3>Object types (OBJTYPE)</h3>
|
||
|
|
<p>Specifies the type of object that is retrieved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>The first object type found with the specified object name that was archived from the specified library is retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the type of object to be retrieved, such as command (*CMD), file (*FILE), or program (*PGM). For a complete list of object types, position the cursor on the field for the <b>Object type (OBJTYPE)</b> parameter, and press the F4 key while prompting the command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.GEN"></a>
|
||
|
|
<h3>Generation (GEN)</h3>
|
||
|
|
<p>Specifies which generation of the archived object to retrieve.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The current archive is restored. This is the newest archive that exists. This is equivalent to specifying a value of 0.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>-98-0</i></b></dt>
|
||
|
|
<dd>Each archive of the object represents a new generation. To retrieve the most recent archive, specify the value 0. To retrieve the one before that, specify the value -1. Up to 99 generations may be retained. The maximum for a particular object is controlled by the object policy that is used when it is archived. If you specify a generation that does not exist, a diagnostic message is issued that also tells you how many generations do exist.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies under what conditions the object is retrieved to disk.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NEW</u></b></dt>
|
||
|
|
<dd>The object is retrieved only if it does not already exist in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>The object is retrieved only if it already exists in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FREE</b></dt>
|
||
|
|
<dd>The object is retrieved only if it already exists in the library on the system with its storage freed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The object in the archived library is retrieved to the library on the system regardless of whether it already exists or not in the library on the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.FILEMBR"></a>
|
||
|
|
<h3>File member (FILEMBR)</h3>
|
||
|
|
<p>Specifies the database file members to restore. This parameter cannot be specified if *MATCH is specified on the <b>Database member option (MBROPT)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>The <b>Object type (OBJTYPE)</b> parameter must be *ANY, or *FILE.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<p>The member name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All members are retrieved from the specified file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No members are retrieved from the specified file. Only the file description is retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-member-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the members to retrieve from the specified file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member to retrieve from the specified file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.MBROPT"></a>
|
||
|
|
<h3>Database member option (MBROPT)</h3>
|
||
|
|
<p>Specifies, for database files already known to the system, which members are restored. Unless *MATCH is used, the member list in the archived file need not match, member for member, the current version on the system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MATCH</u></b></dt>
|
||
|
|
<dd>The archived members are retrieved if the members in the archived file match, member for member, with the members in the current system version.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All members in the archived file are retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>Only new members (members not known to the system) are retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>Only members already known to the system are retrieved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.ALWOBJDIF"></a>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.RTVLIB"></a>
|
||
|
|
<h3>Retrieve to library (RTVLIB)</h3>
|
||
|
|
<p>Specifies whether the object is retrieved to a different library or to the same library from which it was archived.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIB</u></b></dt>
|
||
|
|
<dd>The object is retrieved to the same library from which it was archived.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the archived object should be placed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.RTVASP"></a>
|
||
|
|
<h3>Retrieve to ASP (RTVASP)</h3>
|
||
|
|
<p>Specifies whether the object is retrieved to the auxiliary storage pool (ASP) from which it was archived or to another ASP. Objects may be retrieved to user ASPs (2 through 32). However, some objects cannot be restored to user ASPs.
|
||
|
|
</p>
|
||
|
|
<p>More information about object types which can be restored to user ASPs is in the operating system's Backup and Recovery. If the library exists in the system ASP, journals, journal receivers, and save files can be restored to user ASPs. All other object types will be restored to the ASP of the library.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ARCASP</u></b></dt>
|
||
|
|
<dd>The object is retrieved to the ASP from which it was archived.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>When the specified ASP is 1, the object is retrieved to the system ASP, and when the ASP ranges from 2 through 32, the object is retrieved to the user ASP specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRTVRDAR.DLTSAVF"></a>
|
||
|
|
<h3>Delete save file (DLTSAVF)</h3>
|
||
|
|
<p>Specifies if the temporary save file should be deleted by this command or retained and managed by the Object Management Cycle (OMC). If you are retrieving multiple objects from the same archive by issuing multiple commands, then you don't want to delete this temporary save file until the last object has been retrieved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*OMC</u></b></dt>
|
||
|
|
<dd>The temporary save file is managed by OMC. The retention value specified in the object policy determines how long the save file is kept on disk.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>The temporary save file is deleted when this command completes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRTVRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Simple Example</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRTVRDAR OBJ(ACCTDETAIL) LIB(ACCTINGLIB)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command retrieves a single object in a library that was previously archived using OnDemand Object Archive. This command example retrieves the most current generation of any object type with the name ACCTDETAIL that was archived from the ACCTINGLIB library, and places it back into the ACCTINGLIB library on disk.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: More Complex Example</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRTVRDAR OBJ(ACCTDETAIL) LIB(ACCTINGLIB) OBJTYPE(*FILE) GEN(-1)
|
||
|
|
RTVLIB(ACCTINGTMP) DLTSAVF(*IMMED)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command is similar to Example 1 but only retrieves *FILE object types. It retrieves not the most current generation of the file, but instead retrieves the one PRIOR to the most current archived generation. This example also places the retrieved file into an alternate library called ACCTINGTMP and immediately deletes the OnDemand Object Archive save file that contained the object that was retrieved.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRTVRDAR.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1338</b></dt>
|
||
|
|
<dd>Errors occurred on SBMJOB command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RDR0320</b></dt>
|
||
|
|
<dd>&1 Stored reports checked, &2 processed, &3 failed
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRTVRDAR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|