911 lines
36 KiB
HTML
911 lines
36 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 (SAVRST)</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="SAVRST.Top_Of_Page"></a>
|
|
<h2>Save Restore (SAVRST)</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="#SAVRST.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SAVRST.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SAVRST.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SAVRST"></a>
|
|
<p>The Save/Restore IFS (SAVRST) command saves and restores a copy of one or more objects, that can be used in the integrated file system (IFS).
|
|
</p>
|
|
<p>For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>The SAVRST command uses the current save and restore support for objects in libraries and for document library objects. As a result, there are restrictions when you use the SAVRST command on these objects.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>For name patterns in the root directory:
|
|
<ol>
|
|
<li>OBJ must be one of the following:
|
|
<ul>
|
|
<li>OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
|
|
</li>
|
|
<li>OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT) ('/other values' *OMIT)
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>For names involving objects in libraries:
|
|
<ol>
|
|
<li>OBJ must have only one name, except when omitting /QSYS.LIB from /*
|
|
</li>
|
|
<li>OBJ must be one of the following:
|
|
<ul>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/*')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/*.type')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/objname.type')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/filename.FILE/*')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/filename. FILE/*.MBR')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/libname.LIB/filename. FILE/membername.MBR')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/*.type')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/objname.type')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/filename.FILE/*')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/filename.FILE/*.MBR')
|
|
</li>
|
|
<li>OBJ('/QSYS.LIB/filename. FILE/membername.MBR')
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>The .type must be an object type supported by SAVOBJ and RSTOBJ
|
|
</li>
|
|
<li>libname cannot be QSYS, QDOC, QDOCxxxx, QTEMP, QSPL, QSPLxxxx, QSRV, QRECOVERY, QRPLOBJ, or QSR if libname.LIB is the last component of the name
|
|
</li>
|
|
<li>SUBTREE must be *ALL
|
|
</li>
|
|
<li>For SAVRST:
|
|
<ul>
|
|
<li>CHGPERIOD end date and end time must be *ALL
|
|
</li>
|
|
<li>CHGPERIOD must be default if a file member is specified
|
|
</li>
|
|
<li>An object cannot be renamed
|
|
</li>
|
|
<li>For database file members, OPTION(*NEW) only restores members for new files
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>For names involving document library objects:
|
|
<ol>
|
|
<li>OBJ must have only one name, except when omitting /QDLS from /*
|
|
</li>
|
|
<li>OBJ and SUBTREE must be one of the following:
|
|
<ul>
|
|
<li>OBJ('/QDLS/path/foldername') SUBTREE(*ALL)
|
|
</li>
|
|
<li>OBJ('/QDLS/path/documentname') SUBTREE(*OBJ)
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>For SAVRST:
|
|
<ul>
|
|
<li>The defaults must be taken on the PRECHK and SAVACTMSGQ parameters
|
|
</li>
|
|
<li>CHGPERIOD must be default with OBJ('/QDLS/path/documentname') SUBTREE(*OBJ)
|
|
</li>
|
|
<li>CHGPERIOD start date cannot be *LASTSAVE
|
|
</li>
|
|
<li>CHGPERIOD end date and end time must be *ALL
|
|
</li>
|
|
<li>SAVACT cannot be *SYNC
|
|
</li>
|
|
<li>SAVACTMSGQ must be *NONE
|
|
</li>
|
|
<li>ALWOBJDIF must be *NONE or *ALL
|
|
</li>
|
|
<li>OPTION must be *ALL
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SAVRST.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="#SAVRST.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 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SAVRST.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Objects</td>
|
|
<td valign="top">Values (up to 50 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name</td>
|
|
<td valign="top">
|
|
<i>Path name</i>, <b><u>*</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SAVRST.PATTERN"><b>PATTERN</b></a></td>
|
|
<td valign="top">Name pattern</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: Pattern</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.SUBTREE"><b>SUBTREE</b></a></td>
|
|
<td valign="top">Directory subtree</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *DIR, *OBJ, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#SAVRST.CHGPERIOD"><b>CHGPERIOD</b></a></td>
|
|
<td valign="top">Time period for last change</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Start time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: End date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: End time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.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="#SAVRST.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="#SAVRST.SAVACT"><b>SAVACT</b></a></td>
|
|
<td valign="top">Save active</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES, *SYNC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.SAVACTMSGQ"><b>SAVACTMSGQ</b></a></td>
|
|
<td valign="top">Save active message queue</td>
|
|
<td valign="top"><i>Path name</i>, <b><u>*NONE</u></b>, *WRKSTN</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.ASPDEV"><b>ASPDEV</b></a></td>
|
|
<td valign="top">ASP device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALLAVL</u></b>, *, *SYSBAS, *CURASPGRP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.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="#SAVRST.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 2 repetitions): *OWNER, *AUTL, *PGP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SAVRST.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" rowspan="3"><a href="#SAVRST.SCAN"><b>SCAN</b></a></td>
|
|
<td valign="top">Scan objects</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Scan during save</td>
|
|
<td valign="top">
|
|
<b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Save failed objects</td>
|
|
<td valign="top">
|
|
<b><u>*NOSAVFAILED</u></b>, *SAVFAILED</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.CRTPRNDIR"><b>CRTPRNDIR</b></a></td>
|
|
<td valign="top">Create parent directories</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVRST.PRNDIROWN"><b>PRNDIROWN</b></a></td>
|
|
<td valign="top">Parent directory owner</td>
|
|
<td valign="top"><i>Simple name</i>, <b><u>*PARENT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SAVRST.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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.OBJ"></a>
|
|
<h3>Objects (OBJ)</h3>
|
|
<p>Specifies the objects to be saved. You can specify an object name pattern for the path name to be used. When a path name is specified that could match many objects, you can specify a value for the <b>Name pattern (PATTERN)</b> parameter to subset the objects that are to be saved.
|
|
</p>
|
|
<p>A maximum of 300 path names can be specified.
|
|
</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>
|
|
<p>Additional information about object name patterns is in the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Element 1: Name </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>'*'</u></b></dt>
|
|
<dd>The objects in the current directory are saved.
|
|
</dd>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify an object path name or a pattern that can match many names.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit </b>
|
|
</p>
|
|
<p>Specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The SUBTREE parameter determines whether the subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>The objects that match the object name pattern are to be saved, unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>The objects that match the object name pattern are not saved. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>The objects will be restored with the same name.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.PATTERN"></a>
|
|
<h3>Name pattern (PATTERN)</h3>
|
|
<p>Specifies one or more object name patterns to be used to subset the objects to be saved. The <b>Objects (OBJ)</b> parameter defines the set of candidate objects. A maximum of 50 values can be specified for this parameter.
|
|
</p>
|
|
<p><b>Element 1: Pattern </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>All objects which qualify for the operation are included or omitted.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify an object name or a pattern that can match many names.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit </b>
|
|
</p>
|
|
<p>Specifies whether names that match the pattern should be included or omitted from the operation.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The SUBTREE parameter determines whether the subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>Only objects which are included by the OBJ parameter and match the PATTERN parameter are included in the save, unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>All objects which are included by the OBJ parameter are included in the save except those objects which match the PATTERN parameter. This overrides an *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.SUBTREE"></a>
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
|
<p>Specifies whether directory subtrees are included in the save operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The entire subtree of each directory that matches the object name pattern is included. The subtree includes all subdirectories and the objects within those subdirectories.
|
|
</dd>
|
|
<dt><b>*DIR</b></dt>
|
|
<dd>The objects in the first level of each directory that matches the object name pattern are included. The subdirectories of each matching directory are included, but the objects in the subdirectories are not included.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No subtrees are included in the save operation. If a directory matches the object name pattern specified, the objects in the directory are included. If the directory has subdirectories, neither the subdirectories nor the objects in the subdirectories are included.
|
|
</dd>
|
|
<dt><b>*OBJ</b></dt>
|
|
<dd>Only the objects that exactly match the object name pattern will be processed. If the object name pattern specifies a directory, objects in the directory are not included.
|
|
</dd>
|
|
<dt><b>*STG</b></dt>
|
|
<dd>The objects that match the object name pattern are processed along with the storage for related objects. Objects that are saved using this value can only be restored using SUBTREE(*STG).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.CHGPERIOD"></a>
|
|
<h3>Time period for last change (CHGPERIOD)</h3>
|
|
<p>Specifies a date/time range. Objects that were last changed within that range will be saved.
|
|
</p>
|
|
<p><b>Element 1: Start date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>No starting date is specified. All objects last changed prior to the ending date will be saved.
|
|
</dd>
|
|
<dt><b>*LASTSAVE</b></dt>
|
|
<dd>The objects that have changed since the last time they were saved with UPDHST(*YES) specified are saved. <b>Notes:</b>
|
|
<ol>
|
|
<li>If this value is specified, the value *ALL must be specified for all other elements of this parameter.
|
|
</li>
|
|
<li>For local file systems, the system archive attribute is used. For remote file systems, the PC archive attribute is used.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date after which objects that have changed are to be saved. The date must be specified in job date format.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Start time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All times of day are included in the range.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time on the start date after which objects that have changed are to be saved.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>The time is specified in 24-hour format with or without a time separator as follows:
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue 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 fails.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>Specifying an explicit time is valid only if the starting date is an explicit date.
|
|
</p>
|
|
<p><b>Element 3: End date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>No ending date is specified. All objects changed since the starting date will be saved.
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date before which objects that have changed are to be saved. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: End time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All times of day are included in the range.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify a time on the end date before which objects that have changed are to be saved.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>The time is specified in 24-hour format with or without a time separator as follows:
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue 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 fails.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>Specifying an explicit time is valid only if the ending date is an explicit date.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.PRECHK"></a>
|
|
<h3>Object pre-check (PRECHK)</h3>
|
|
<p>Specifies whether the save operation ends if any of the selected objects cannot be saved.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The save operation does not end. Objects that can be saved are saved.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The save operation ends. Nothing is saved unless all of the selected objects can be saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.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, this parameter is ignored and 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>*YES</b></dt>
|
|
<dd>Objects can be saved and used at the same time. The object checkpoints can occur at different times.
|
|
</dd>
|
|
<dt><b>*SYNC</b></dt>
|
|
<dd>Objects can be saved and used at the same time. All of the object checkpoints occur at the same time.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.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 is complete.
|
|
</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>*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.
|
|
</dd>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the path name of the message queue to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) device to be included in the save operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>The operation uses the ASPDEV value appropriate for the file system from which objects are being saved. For Integrated File System objects, *ALLAVL is used. For objects from the QSYS file system, the corresponding save command ASPDEV default is used.
|
|
</dd>
|
|
<dt><b>*ALLAVL</b></dt>
|
|
<dd>The operation includes the system ASP (ASP number 1), all basic user ASPs (ASP numbers 2-32), and all available independent ASPs.
|
|
</dd>
|
|
<dt><b>*</b></dt>
|
|
<dd>The operation includes the system ASP, all basic user ASPs, 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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies whether to restore objects that already exist on the system or objects that do not already exist on the system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All of the specified objects are restored, whether they already exist on the system or not.
|
|
</dd>
|
|
<dt><b>*NEW</b></dt>
|
|
<dd>Objects are restored only if they do not already exist on the system.
|
|
</dd>
|
|
<dt><b>*OLD</b></dt>
|
|
<dd>Objects are restored only if they already exist on the system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.ALWOBJDIF"></a>
|
|
<h3>Allow object differences (ALWOBJDIF)</h3>
|
|
<p>Specifies whether differences are allowed between the saved objects and the restored objects.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have all object (*ALLOBJ) special authority to specify any value other than *NONE for this parameter.
|
|
</li>
|
|
<li>If differences are found, the final message for the restore operation is an escape message rather than the normal completion message.
|
|
</li>
|
|
</ol>
|
|
<p>The types of differences include:
|
|
</p>
|
|
<ul>
|
|
<li>Authorization list: The saved object had an authorization list, and either the object exists on the system but does not have the same authorization list, or the object does not exist and it is being restored to a different system than the save system.
|
|
<p>
|
|
<b>Note: </b>This parameter has no effect when the saved object did not have an authorization list. If the object exists, it is restored with the authorization list of the existing object. If it does not exist, it is restored with no authorization list.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li>Ownership: The owner of an object on the system is different than the owner of an object from the save operation.
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li>Primary Group: The primary group of an object on the system is different than the primary group of an object from the save operation.
|
|
</li>
|
|
</ul>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>None of the differences listed above are allowed on the restore operation. See the description of each individual value to determine how differences are handled.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All of the differences listed above are allowed on the restore operation. See the description of each individual value to determine how differences are handled.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AUTL</b></dt>
|
|
<dd>Authorization list differences are allowed. If the saved object had an authorization list and the object exists on the system but does not have the same authorization list, the object is restored with the authorization list of the existing object. If the saved object had an authorization list and the object does not exist and it is being restored to a different system than the save system, the object is restored and it is linked to the authorization list. If the authorization list does not exist, the public authority is set to *EXCLUDE.
|
|
<p>If this value is not specified, authorization list differences are not allowed. If the saved object had an authorization list and the object exists on the system but does not have the same authorization list, the object is not restored. If the saved object had an authorization list and the object does not exist and it is being restored to a different system than the save system, the object is restored, but it is not linked to the authorization list, and the public authority is set to *EXCLUDE.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OWNER</b></dt>
|
|
<dd>Ownership differences are allowed. If an object already exists on the system with a different owner than the saved object, the object is restored with the owner of the object on the system.
|
|
<p>If this value is not specified, ownership differences are not allowed. If an object already exists on the system with a different owner than the saved object, the object is not restored.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PGP</b></dt>
|
|
<dd>Primary group differences are allowed. If an object already exists on the system with a different primary group than the saved object, the object is restored with the primary group of the object on the system.
|
|
<p>If this value is not specified, primary group differences are not allowed. If an object already exists on the system with a different primary group than the saved object, the object is not restored.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.SCAN"></a>
|
|
<h3>Scan objects (SCAN)</h3>
|
|
<p>Specifies whether objects will be scanned while being saved when exit programs are registered with any of the integrated file system scan-related exit points and whether objects that previously failed a scan should be saved.
|
|
</p>
|
|
<p>The integrated file system scan-related exit points are:
|
|
</p>
|
|
<ul>
|
|
<li>QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
|
|
</li>
|
|
<li>QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program
|
|
</li>
|
|
</ul>
|
|
<p>For details on these exit points, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Element 1: Scan during save</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Objects will not be scanned by the scan-related exit programs.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Objects will be scanned according to the rules described in the scan-related exit programs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Save failed objects</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOSAVFAILED</u></b></dt>
|
|
<dd>Objects that have either previously failed a scan or that fail a scan by a QIBM_QP0L_SCAN_OPEN exit program during this save will not be saved.
|
|
</dd>
|
|
<dt><b>*SAVFAILED</b></dt>
|
|
<dd>Objects that have either previously failed a scan or that fail a scan during this save will be saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.CRTPRNDIR"></a>
|
|
<h3>Create parent directories (CRTPRNDIR)</h3>
|
|
<p>Specifies whether parent directories of objects being restored should be created if they do not exist. For example, if object '/a/b/c/file1' is being restored then directories '/a', '/a/b' and '/a/b/c' must exist. This parameter only applies to "root" (/), QOpenSys and user-defined file systems, and will be ignored for all other file systems.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Parent directories will not be created if they do not exist. Diagnostic message CPD375B will be sent and the object will not be restored.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The restore will create parent directories if they do not exist. The directories created by the restore will have *EXCLUDE public authority and will be owned by the user profile specified for the <b>Parent directory owner (PRNDIROWN)</b> parameter. The other parent directory attributes will be set using the shipped default values for the <b>Create Directory (CRTDIR)</b> command parameters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVRST.PRNDIROWN"></a>
|
|
<h3>Parent directory owner (PRNDIROWN)</h3>
|
|
<p>Specifies the name of an existing user profile that will own parent directories created by the restore. This parameter only applies to "root" (/), QOpenSys and user-defined file systems, and will be ignored for all other file systems.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If a value is specified for this parameter, *YES must be specified for the <b>Create parent directories (CRTPRNDIR)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PARENT</u></b></dt>
|
|
<dd>The owner of a parent directory being created by the restore will be the same as the owner of the directory it is being created into. For example, if object '/a/b/c/file1' is being restored and directory '/a' exists but the '/b' and '/b/c' directories do not exist, the '/b' and '/b/c' directories are created with the same owner as the '/a' directory.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a user profile to be the owner of any parent directories that are created by the restore.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVRST.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Saving and Restoring a Member Object</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVRST RMTLOCNAME(SYSTEM1)
|
|
OBJ(('QSYS.LIB/JTEMP.LIB/ZXC.FILE/QYYCPDGT.MBR'))
|
|
</pre>
|
|
</p>
|
|
<p>This command saves the QYYCPDGT member from file ZXC in library JTEMP and restores the object on the iSeries system at remote location SYSTEM1.
|
|
</p>
|
|
<p><b>Example 2: Saving and Restoring a Directory</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVRST RMTLOCNAME(SYSTEM2) OBJ(('MYDIR')) SAVACT(*YES)
|
|
SAVACTMSGQ('QSYS.LIB/SVRTEST.LIB/ZXC.MSGQ')
|
|
</pre>
|
|
</p>
|
|
<p>This command saves the MYDIR directory while active, and will use the ZXC message queue in library SVRTEST to save messages.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVRST.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="#SAVRST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|