1146 lines
55 KiB
HTML
1146 lines
55 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>Save Restore Changed Objects (SAVRSTCHG)</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="SAVRSTCHG.Top_Of_Page"></a>
|
||
|
|
<h2>Save Restore Changed Objects (SAVRSTCHG)</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="#SAVRSTCHG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVRSTCHG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVRSTCHG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVRSTCHG"></a>
|
||
|
|
<p>The Save/Restore Changed Object (SAVRSTCHG) command saves and concurrently restores a copy of each changed object, or group of objects located in the same library, to another system. For database files, only the changed members are saved and restored. Objects or members changed since the specified date and time are saved and restored.
|
||
|
|
</p>
|
||
|
|
<p>Objects changed since the specified date and time are saved and restored with the following exceptions:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If OBJJRN(*NO) is specified, objects currently being journaled are not saved and restored, unless journaling was started after the specified date and time. This ensures that changes made to objects before journaling starts are not lost (because they were not journaled in a journal receiver).
|
||
|
|
</li>
|
||
|
|
<li>Freed objects (programs, files, journal receivers, and so forth) are not saved.
|
||
|
|
</li>
|
||
|
|
<li>User-defined messages, job and output queue definitions, logical file definitions, and data queue descriptions are saved and restored, but the contents of those objects are not saved and restored. Logical file access paths are saved and restored if ACCPTH(*YES) is specified.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Specified objects that were changed, and the libraries where they reside, remain locked during the save and restore operation.
|
||
|
|
</p>
|
||
|
|
<p>To determine the date and time that an object was changed, run the Display Object Description (DSPOBJD) command with DETAIL(*FULL) specified. For database file members that were changed, run the Display File Description (DSPFD) command.
|
||
|
|
</p>
|
||
|
|
<p>The types of objects that can be saved and restored by this command are listed in the OBJTYPE parameter description in "Commonly used parameters: Expanded descriptions" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter. The system saves and concurrently restores the changed objects.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>To use this command, the user must have the special authority *SAVSYS specified in the user profile by the SPCAUT parameter. Otherwise, the user must have object existence authority for each object specified, and execute authority to the specified library. If the user does not have the necessary authority to a specified object, all changed objects except that object are saved and restored.
|
||
|
|
</li>
|
||
|
|
<li>No changed object that is being saved and restored can be changed by a job that is running when the save and restore operation occurs unless save-while-active is used.
|
||
|
|
</li>
|
||
|
|
<li>When the contents of a save file are saved with SAVFDTA(*YES), the save file must be restored before objects contained in it can be restored.
|
||
|
|
</li>
|
||
|
|
<li>Both systems intended to participate in the save and restore operation must be connected to the same APPN network or, if the OptiConnect for I5/OS option is to be used, both systems must be joined by the OptiConnect for I5/OS hardware and software.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVRSTCHG.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="#SAVRSTCHG.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="#SAVRSTCHG.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Saved library</td>
|
||
|
|
<td valign="top">Single values: *ALLUSR<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="#SAVRSTCHG.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location name</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.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 72 repetitions): *ALRTBL, *BNDDIR, *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, *ORTBL, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRTIMG, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *USRIDX, *TIMZON, *USRQ, *USRSPC, *VLDL, *WSCST</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.OBJJRN"><b>OBJJRN</b></a></td>
|
||
|
|
<td valign="top">Journaled objects</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.REFDATE"><b>REFDATE</b></a></td>
|
||
|
|
<td valign="top">Reference date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*SAVLIB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.REFTIME"><b>REFTIME</b></a></td>
|
||
|
|
<td valign="top">Reference time</td>
|
||
|
|
<td valign="top"><i>Time</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.STRLIB"><b>STRLIB</b></a></td>
|
||
|
|
<td valign="top">Starting library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.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="#SAVRSTCHG.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>, *ALL, <b><u>*NONE</u></b></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>, *ALRTBL, *BNDDIR, *CHTFMT, *CLD, *CLS, *CMD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *DTAARA, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LOCALE, *MEDDFN, *MENU, *MGTCOL, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODGRP, *NODL, *ORTBL, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *S36, *TIMZON, *TBL, *USRIDX, *USRQ, *USRSPC, *VLDL, *WSCST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">ASP device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *SYSBAS, *CURASPGRP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><i>Simple name</i>, <b><u>*CURRENT</u></b>, *PRV</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.PRECHK"><b>PRECHK</b></a></td>
|
||
|
|
<td valign="top">Object pre-check</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.SAVACT"><b>SAVACT</b></a></td>
|
||
|
|
<td valign="top">Save active</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *LIB, *SYSDFN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#SAVRSTCHG.SAVACTWAIT"><b>SAVACTWAIT</b></a></td>
|
||
|
|
<td valign="top">Save active wait time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object locks</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>120</u></b>, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Pending record changes</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>*LOCKWAIT</u></b>, *NOCMTBDY, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Other pending changes</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>*LOCKWAIT</u></b>, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVRSTCHG.SAVACTMSGQ"><b>SAVACTMSGQ</b></a></td>
|
||
|
|
<td valign="top">Save active message queue</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 active message queue</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *WRKSTN</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="#SAVRSTCHG.ACCPTH"><b>ACCPTH</b></a></td>
|
||
|
|
<td valign="top">Save access paths</td>
|
||
|
|
<td valign="top"><b><u>*SYSVAL</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.SAVFDTA"><b>SAVFDTA</b></a></td>
|
||
|
|
<td valign="top">Save file data</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.QDTA"><b>QDTA</b></a></td>
|
||
|
|
<td valign="top">Queue data</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *DTAQ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.RSTLIB"><b>RSTLIB</b></a></td>
|
||
|
|
<td valign="top">Restore 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="#SAVRSTCHG.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="#SAVRSTCHG.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"><a href="#SAVRSTCHG.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *NEW, *OLD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTCHG.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="#SAVRSTCHG.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
|
||
|
|
<td valign="top">Allow object differences</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *ALL<br>Other values (up to 3 repetitions): *AUTL, *OWNER, *PGP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVRSTCHG.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>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVRSTCHG.OBJ"></a>
|
||
|
|
<h3>Objects (OBJ)</h3>
|
||
|
|
<p>Specifies the names of one or more objects, or the generic names of each group of objects, to check for changes and then to save those objects that have changed. All the objects must be in the library specified for the <b>Library (LIB)</b> parameter. If *ALL is specified or defaulted for the <b>Object types (OBJTYPE)</b> parameter, all the object types listed in the description of that parameter are saved, provided they are in the specified library and 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 changed objects in the specified libraries are saved, depending on the values specified for the OBJTYPE parameter.
|
||
|
|
</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 changed objects to save in the specified library. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * 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 the names of specific objects to save. 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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.LIB"></a>
|
||
|
|
<h3>Saved library (LIB)</h3>
|
||
|
|
<p>Specifies the library that contains the changed objects to be saved and restored.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALLUSR</u></b></dt>
|
||
|
|
<dd>All user libraries are saved and restored. All libraries with names that do not begin with the letter Q are saved and restored except for the following:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also saved and restored:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
|
||
|
|
QGPL QSRVAGT QUSRINFSKR
|
||
|
|
QGPL38 QSYS2 QUSRNOTES
|
||
|
|
QMGTC QSYS2xxxxx QUSROND
|
||
|
|
QMGTC2 QS36F QUSRPOSGS
|
||
|
|
QMPGDATA QUSER38 QUSRPOSSA
|
||
|
|
QMQMDATA QUSRADSM QUSRPYMSVR
|
||
|
|
QMQMPROC QUSRBRM QUSRRDARS
|
||
|
|
QPFRDATA QUSRDIRCL QUSRSYS
|
||
|
|
QRCL QUSRDIRDB QUSRVI
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
|
||
|
|
</p>
|
||
|
|
</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 library. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all libraries with names that begin with the generic prefix, for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete library name. Up to 300 generic library values can be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be saved and restored. Up to 300 library names can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.RMTLOCNAME"></a>
|
||
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies the remote location to connect with. Specify the remote location name using the format cccccccc or nnnnnnnn.cccccccc, where nnnnnnnn is the network identifier (ID) and cccccccc is the remote location name.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
||
|
|
<dd>Specify the remote location name associated with the system to which you want to restore objects. The local network ID (LCLNETID) network attribute is used as the value of the network identifier.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-ID.location-name</i></b></dt>
|
||
|
|
<dd>Specify the network identifier and the remote location name associated with the system to which you want to restore objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.OBJTYPE"></a>
|
||
|
|
<h3>Object types (OBJTYPE)</h3>
|
||
|
|
<p>Specifies the types of system objects whose changes are saved. The object types saved are also the ones saved and restored by the Save Library (SAVLIB), Restore Object (RSTOBJ), and Restore Library (RSTLIB) commands. Data dictionaries and the associated files are saved only by using the SAVLIB command.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Changes to all object types that are specified by name, and which are in the specified library, are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the value for each of the types of objects that are saved, 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>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.OBJJRN"></a>
|
||
|
|
<h3>Journaled objects (OBJJRN)</h3>
|
||
|
|
<p>Specifies whether to save changed objects that are currently being journaled and that have been journaled since the date and time specified for the <b>Reference date (REFDATE)</b> and <b>Reference time (REFTIME)</b> parameters.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Objects being journaled are not saved. If journaling was started after the specified date and time, the changed objects or changed database file members are saved. The date and time of the last journal start operation can be shown by using the Display Object Description (DSPOBJD) command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Objects whose changes are entered in a journal are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.REFDATE"></a>
|
||
|
|
<h3>Reference date (REFDATE)</h3>
|
||
|
|
<p>Specifies the reference date. Objects that have been changed since this date are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVLIB</u></b></dt>
|
||
|
|
<dd>The objects that have been changed since the date of the last running of the Save Library (SAVLIB) command are saved. If the specified library was never saved, a message is issued and the library is not saved, but the operation continues.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the reference date; objects that have been changed since this date are saved. If you specify a date later than the date of the running of this command, a message is issued and the operation ends. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.REFTIME"></a>
|
||
|
|
<h3>Reference time (REFTIME)</h3>
|
||
|
|
<p>Specifies the reference time. Objects that have been changed since this time on the specified date are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No explicit time is specified. Any objects changed since the date specified for the <b>Reference date (REFDATE)</b> parameter are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the reference time; objects that have been changed since this time on the specified date are saved. If *SAVLIB is specified for the REFDATE parameter, no reference time can be specified. If you specify a time later than the time of the running of this command, a message is issued and the operation ends.
|
||
|
|
<p>The time can be specified with or without a time separator:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 6 digits (hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.STRLIB"></a>
|
||
|
|
<h3>Starting library (STRLIB)</h3>
|
||
|
|
<p>Specifies the library with which to begin the *ALLUSR save. This parameter is used to recover from ended or failed *ALLUSR save operations.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The save operation begins with the first library in alphabetical order.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library with which to begin the save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.OMITLIB"></a>
|
||
|
|
<h3>Libraries to omit (OMITLIB)</h3>
|
||
|
|
<p>Specifies the names of one of more libraries, or the generic names of each group of libraries, to be excluded from the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No libraries are excluded from the save 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. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all libraries with names that begin with the generic prefix, for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete library name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.ASPDEV"></a>
|
||
|
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
|
<p>Specifies the auxiliary storage pool (ASP) device to be included in the save operation. This parameter is used to subset the list of objects which qualify for the SAV based on the OBJ parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The operation includes the system ASP (ASP number 1), all basic user ASPs (ASP numbers 2-32), and, if the current thread has an ASP group, all independent ASPs in the ASP group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSBAS</b></dt>
|
||
|
|
<dd>The system ASP and all basic user ASPs are included in the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURASPGRP</b></dt>
|
||
|
|
<dd>If the current thread has an ASP group, all independent ASPs in the ASP group are included in the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the ASP device to be included in the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release level of the operating system on which you intend to use the object being saved.
|
||
|
|
</p>
|
||
|
|
<p>When specifying the <b>target-release</b> value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.
|
||
|
|
</p>
|
||
|
|
<p>Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The object is to be restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.PRECHK"></a>
|
||
|
|
<h3>Object pre-check (PRECHK)</h3>
|
||
|
|
<p>Specifies whether the save operation for a library ends if any of the following are true:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The objects do not exist
|
||
|
|
</li>
|
||
|
|
<li>The library or the objects were previously found to be damaged
|
||
|
|
</li>
|
||
|
|
<li>The library or the objects are locked by another job
|
||
|
|
</li>
|
||
|
|
<li>The requester of the save operation does not have authority for the library or to save the objects.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The save operation for a library continues, saving only those objects that can be saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>If, after all specified objects are checked, one or more objects cannot be saved, the save operation for a library ends before any data is written. If multiple libraries are specified, the save operation continues with the next library. However, if PRECHK(*YES) and SAVACT(*SYNCLIB) are specified and an object in any library to be saved does not meet the preliminary check conditions, the save operation ends and no objects are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.SAVACT"></a>
|
||
|
|
<h3>Save active (SAVACT)</h3>
|
||
|
|
<p>Specifies whether an object can be updated while it is being saved.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If your system is in a restricted state and the SAVACT parameter is specified, the save operation is performed as if SAVACT(*NO) was specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Objects that are in use are not saved. Objects cannot be updated while being saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b> *LIB</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. All the objects in a library reach a checkpoint together and are saved in a consistent state in relationship to each other.
|
||
|
|
</dd>
|
||
|
|
<dt><b> *SYSDFN</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. Objects in a library may reach checkpoints at different times and may not be in a consistent state in relationship to each other.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.SAVACTWAIT"></a>
|
||
|
|
<h3>Save active wait time (SAVACTWAIT)</h3>
|
||
|
|
<p>Specifies the amount of time to wait for an object that is in use, or for transactions with pending changes to reach a commit boundary, before continuing the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Object locks</b>
|
||
|
|
</p>
|
||
|
|
<p>For each object that is in use, specifies the amount of time to wait for the object to become available. If an object remains in use for the specified time, the object is not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>120</u></b></dt>
|
||
|
|
<dd>The system waits up to 120 seconds for each individual object lock before continuing the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for each individual object lock before continuing the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Pending record changes</b>
|
||
|
|
</p>
|
||
|
|
<p>For each group of objects that are checkpointed together, specifies the amount of time to wait for transactions with pending record changes to reach a commit boundary. The <b>Save active (SAVACT)</b> parameter determines which objects are checkpointed together. If 0 is specified, all objects being saved must be at commit boundaries. If any other value is specified, all objects that are journaled to the same journals as the objects being saved must reach commit boundaries. If a commit boundary is not reached in the specified time, the save operation is ended, unless the value *NOCMTBDY is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCKWAIT</u></b></dt>
|
||
|
|
<dd>The system waits up to the value specified for Element 1 for transactions with pending record changes to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOCMTBDY</b></dt>
|
||
|
|
<dd>The system will save objects without requiring transactions with pending record changes to reach a commit boundary. Therefore, objects may be saved with partial transactions.
|
||
|
|
<p>If you restore an object that was saved with partial transactions, you cannot use the object until you apply or remove journal changes (APYJRNCHG or RMVJRNCHG command) to reach commit boundaries. You will need all journal receivers that contain information about the partial transactions to apply or remove the changes. Until you apply or remove the changes, any future save of that object will include the partial transactions, even if you do not specify *NOCMTBDY.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value cannot be specified if the <b>Target release (TGTRLS)</b> parameter value is earlier than V5R3M0.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for transactions with pending record changes to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Other pending changes</b>
|
||
|
|
</p>
|
||
|
|
<p>For each library, specifies the amount of time to wait for transactions with other pending changes to reach a commit boundary. Other pending changes include the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Data Definition Language (DDL) object level changes for that library.
|
||
|
|
</li>
|
||
|
|
<li>Any API commitment resource that was added without the option to allow normal save processing. For more information, see the Add Commitment Resource (QTNADDCR) API in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If a commit boundary is not reached for a library in the specified time, the library is not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCKWAIT</u></b></dt>
|
||
|
|
<dd>The system waits up to the value specified for Element 1 for the types of transactions that are listed above to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for the types of transactions that are listed above to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>If 0 is specified, and only one name is specified for the <b>Objects (OBJ)</b> parameter, and *FILE is the only value specified for the <b>Object types (OBJTYPE)</b> parameter, the system will save the object without requiring the types of transactions that are listed above to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.SAVACTMSGQ"></a>
|
||
|
|
<h3>Save active message queue (SAVACTMSGQ)</h3>
|
||
|
|
<p>Specifies the message queue that the save operation uses to notify the user that the checkpoint processing for a library is complete. A separate message is sent for each library to be saved when the *SYSDFN or *LIB value is specified for the <b>Save active (SAVACT)</b> parameter. When *SYNCLIB is specified for the SAVACT parameter, one message is sent for all libraries in the save operation.
|
||
|
|
</p>
|
||
|
|
<p>This parameter can be used to save the objects at a known, consistent boundary to avoid additional recovery procedures following a restore operation. Applications can be stopped until the checkpoint processing complete message is received.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No notification message is sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*WRKSTN</b></dt>
|
||
|
|
<dd>The notification message is sent to the work station message queue. This value is not valid in batch mode.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Save active message queue</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue 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 job is used to locate the message queue. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.ACCPTH"></a>
|
||
|
|
<h3>Save access paths (ACCPTH)</h3>
|
||
|
|
<p>Specifies whether the logical file access paths that are dependent on the physical files being saved are also saved. The access paths are saved only in the case of the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>All members on which the access paths are built are included in this save operation.
|
||
|
|
</li>
|
||
|
|
<li>The access paths are not invalid or damaged at the time of the save.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The system checks to ensure the integrity of the access paths. Any discrepancies found by the system will result in the access paths being rebuilt.
|
||
|
|
</p>
|
||
|
|
<p>Informational messages are sent indicating the number of logical file access paths saved with each physical file. All physical files on which an access path is built must be in the same library. This parameter does not save logical file objects; it only controls the saving of the access paths. More information on the restoring of saved access paths is in the Backup and Recovery book, SC41-5304.
|
||
|
|
</p>
|
||
|
|
<p><b>ATTENTION: If the based-on physical files and the logical files are in different libraries, the access paths are saved. However, if the logical files and the based-on physical files are in different libraries and the logical files or physical files do not exist at restore time (such as during disaster recovery or the files were deleted) the access paths are not restored. They are rebuilt. For the fastest possible restore operation for logical files, the logical files and the based-on physical files must be in the same library and must be saved at the same time.</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
|
<dd>The QSAVACCPTH system value determines whether to save the logical file access paths that are dependent on the physical files that are being saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Only those objects specified on the command are saved. No logical file access paths are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The specified physical files and all eligible logical file access paths over them are saved.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Specifying this value does not save the logical files.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.SAVFDTA"></a>
|
||
|
|
<h3>Save file data (SAVFDTA)</h3>
|
||
|
|
<p>Specifies, for save file objects, whether the description of a save file, or both the description and the contents of a save file, are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The description and contents of a save file are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Only the description of a save file is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.QDTA"></a>
|
||
|
|
<h3>Queue data (QDTA)</h3>
|
||
|
|
<p>Specifies, for queue objects, whether the description of a queue, or both the description and the contents of a queue, are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Only the description of a queue is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DTAQ</b></dt>
|
||
|
|
<dd>The description and contents of a standard data queue are saved. Only the description of a Distributed Data Management (DDM) data queue is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.RSTLIB"></a>
|
||
|
|
<h3>Restore to library (RSTLIB)</h3>
|
||
|
|
<p>Specifies the name of the library to which the objects are restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIB</u></b></dt>
|
||
|
|
<dd>The restore library is the same name as the value specified on the LIB parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to which the objects are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTCHG.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="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVRSTCHG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving and Restoring Multiple Changed Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVRSTCHG OBJ(*ALL) RMTLOCNAME(SYSTEM1) LIB(*ALLUSR)
|
||
|
|
OBJTYPE(*PGM) STRLIB(MORE) ALWOBJDIF(*NONE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all changed objects whose type is *PGM and are located in user libraries beginning with the library named MORE. The objects are restored on the remote system named SYSTEM1.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Saving and Restoring a Specific Changed Object</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVRSTCHG OBJ(PETE) RMTLOCNAME(SYSTEM1) LIB(RON)
|
||
|
|
ALWOBJDIF(*ALL) OPTION(*NEW)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves changed objects named PETE of all types supported, which is located in the library named RON, and restores the object on the remote system named SYSTEM1 if the object does not already exist on the remote system.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVRSTCHG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPCAD80</b></dt>
|
||
|
|
<dd>&1 objects saved and restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD8D</b></dt>
|
||
|
|
<dd>An error occurred during the &1 operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD80</b></dt>
|
||
|
|
<dd>Unable to establish connection from &1 to &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD81</b></dt>
|
||
|
|
<dd>User profile &1 not found on remote location &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD82</b></dt>
|
||
|
|
<dd>Remote location &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD83</b></dt>
|
||
|
|
<dd>Remote location &1 cannot be source location.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD84</b></dt>
|
||
|
|
<dd>ObjectConnect internal error, function code &1, return code &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD86</b></dt>
|
||
|
|
<dd>Location name &1 unable to close &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD88</b></dt>
|
||
|
|
<dd>Unable to establish connection from &1 to &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD93</b></dt>
|
||
|
|
<dd>APPC failure. Failure code is &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF389C</b></dt>
|
||
|
|
<dd>ObjectConnect internal error, function code &1, return code &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTCHG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|