988 lines
39 KiB
HTML
988 lines
39 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 Doc/Lib Object (SAVRSTDLO)</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="SAVRSTDLO.Top_Of_Page"></a>
|
||
|
|
<h2>Save Restore Doc/Lib Object (SAVRSTDLO)</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="#SAVRSTDLO.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVRSTDLO.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVRSTDLO.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVRSTDLO"></a>
|
||
|
|
<p>The Save/Restore Document Library Object (SAVRSTDLO) command saves and restores the following objects to another system. The system must have a supported communication link with the system that the objects are being restored to.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Documents
|
||
|
|
</li>
|
||
|
|
<li>Folders
|
||
|
|
</li>
|
||
|
|
<li>Distribution objects (mail)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>When a folder is saved and restored, the folder object is transferred along with the documents contained in that folder and the subfolders and documents in the subfolders and all successively nested folders and documents. Specific folders can be saved and restored individually using the DLO(*FLRLVL) parameter.
|
||
|
|
</li>
|
||
|
|
<li>Distribution objects (mail) cannot be sent for individual users. Mail can be saved and restored for all users only.
|
||
|
|
</li>
|
||
|
|
<li>SAVRSTDLO does not require a dedicated system; however, individual objects in use when the save and restore command is issued cannot be saved and restored. To ensure all document library objects are saved and restored, run this command when no office activity is occurring on the system.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have *ALLOBJ or *SAVSYS special authority to use the following parameter combinations on this command:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*ALL) FLR(*ANY)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*CHG)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*MAIL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) OWNER(*ALL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) OWNER(<i>user-profile-name</i>)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>where the <i>user profile name</i> specified is not the <i>user profile name</i> of the user issuing the SAVRSTDLO command.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
<li>Users that do not have *ALLOBJ or *SAVSYS special authority must:
|
||
|
|
<ul>
|
||
|
|
<li>Have *ALL authority for each document or folder to be sent.
|
||
|
|
</li>
|
||
|
|
<li>Be enrolled as Document Interchange Architecture (DIA) users.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>This command cannot be used while another job is running commands such as RCLDLO, SAVDLO, and RSTDLO because exclusive use of internal objects may have been obtained by these commands.
|
||
|
|
</li>
|
||
|
|
<li>Determining document or folder ownership does not include checking group profiles if one is associated with the specified user profile.
|
||
|
|
</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="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVRSTDLO.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="#SAVRSTDLO.DLO"><b>DLO</b></a></td>
|
||
|
|
<td valign="top">Document library object</td>
|
||
|
|
<td valign="top">Single values: *ALL, *SEARCH, *CHG, *DOCL, *MAIL, *FLRLVL<br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.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 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.FLR"><b>FLR</b></a></td>
|
||
|
|
<td valign="top">Folder</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ANY</u></b>, *NONE<br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.OMITFLR"><b>OMITFLR</b></a></td>
|
||
|
|
<td valign="top">Folders to omit</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.SRCHTYPE"><b>SRCHTYPE</b></a></td>
|
||
|
|
<td valign="top">Search type</td>
|
||
|
|
<td valign="top"><b><u>*DOC</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.CHKEXP"><b>CHKEXP</b></a></td>
|
||
|
|
<td valign="top">Expiration date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*NO</u></b>, *CURRENT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#SAVRSTDLO.CRTDATE"><b>CRTDATE</b></a></td>
|
||
|
|
<td valign="top">Creation date</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Starting time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Starting time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Starting date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*BEGIN</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Ending time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*END</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.DOCCLS"><b>DOCCLS</b></a></td>
|
||
|
|
<td valign="top">Document class</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*ANY</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.OWNER"><b>OWNER</b></a></td>
|
||
|
|
<td valign="top">Owner profile</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*CURRENT</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.REFCHGDATE"><b>REFCHGDATE</b></a></td>
|
||
|
|
<td valign="top">Last changed date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*ANY</u></b>, *SAVDLOALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.REFCHGTIME"><b>REFCHGTIME</b></a></td>
|
||
|
|
<td valign="top">Last changed time</td>
|
||
|
|
<td valign="top"><i>Time</i>, <b><u>*ANY</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.DOCL"><b>DOCL</b></a></td>
|
||
|
|
<td valign="top">Document list</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.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="#SAVRSTDLO.STG"><b>STG</b></a></td>
|
||
|
|
<td valign="top">Storage</td>
|
||
|
|
<td valign="top"><b><u>*KEEP</u></b>, *DELETE, *FREE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVRSTDLO.CMDCHRID"><b>CMDCHRID</b></a></td>
|
||
|
|
<td valign="top">Command character identifier</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Graphic character set</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Integer</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Code page</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Integer</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.SAVACT"><b>SAVACT</b></a></td>
|
||
|
|
<td valign="top">Save active</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.SAVACTWAIT"><b>SAVACTWAIT</b></a></td>
|
||
|
|
<td valign="top">Save active wait time</td>
|
||
|
|
<td valign="top">0-99999, <b><u>120</u></b>, *NOMAX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.ASP"><b>ASP</b></a></td>
|
||
|
|
<td valign="top">Auxiliary storage pool ID</td>
|
||
|
|
<td valign="top">1-32, <b><u>*ANY</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.NEWOBJ"><b>NEWOBJ</b></a></td>
|
||
|
|
<td valign="top">Object name generation</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NEW</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.ALWOBJDIF"><b>ALWOBJDIF</b></a></td>
|
||
|
|
<td valign="top">Allow object differences</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVRSTDLO.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>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVRSTDLO.DLO"></a>
|
||
|
|
<h3>Document library object (DLO)</h3>
|
||
|
|
<p>Specifies the document library objects to save. To save a folder, DLO(*ALL) must be specified.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All document library objects further qualified by the FLR parameter are to be saved. Specifying DLO(*ALL) FLR(*ANY) saves all document library objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SEARCH</b></dt>
|
||
|
|
<dd>All document library objects that meet the specified search values are saved. Search values are specified by using the following parameters:
|
||
|
|
<ul>
|
||
|
|
<li><b>Folder (FLR)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Check for mark (CHKFORMRK)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Expiration date (CHKEXP)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Creation date (CRTDATE)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Document class (DOCCLS)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Owner profile (OWNER)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Last changed date (REFCHGDATE)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li><b>Last changed time (REFCHGTIME)</b> parameter.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Folders are saved only if SRCHTYPE(*ALL) is specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHG</b></dt>
|
||
|
|
<dd>All documents created or changed and all folders created since the last complete save operation and all mail is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSOBJNAM</b></dt>
|
||
|
|
<dd>The documents with the system object names specified for the <b>System object name (SYSOBJNAM)</b> parameter are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOCL</b></dt>
|
||
|
|
<dd>The list of documents referred to in a document list specified for the <b>Document list (DOCL)</b> parameter is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MAIL</b></dt>
|
||
|
|
<dd>The distribution objects and documents referred to by a mail log are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FLRLVL</b></dt>
|
||
|
|
<dd>The folders specified for the <b>Folder (FLR)</b> parameter and documents in the folders are saved. Subfolders are not saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>document-name</i></b></dt>
|
||
|
|
<dd>Specify the user-assigned names of the documents that are saved. All documents specified must be in the same folder and that folder must be specified for the <b>Folder (FLR)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>System object name is not supported.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.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="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.FLR"></a>
|
||
|
|
<h3>Folder (FLR)</h3>
|
||
|
|
<p>Specifies the name of the folder to save.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>Document library objects can be saved from any folder. Consider the following when using the FLR parameter:
|
||
|
|
<ul>
|
||
|
|
<li>FLR(*ANY) is not valid when one of the following is specified:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*DOCL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*FLRLVL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(<i>document-name</i>)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>FLR(*ANY) is required when one of the following is specified:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*CHG)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SYSOBJNAM)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*MAIL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) SRCHTYPE(*ALL)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>When SAVDLO DLO(*ALL) FLR(*ANY) is specified, the following are saved:
|
||
|
|
<ul>
|
||
|
|
<li>All documents
|
||
|
|
</li>
|
||
|
|
<li>All folders
|
||
|
|
</li>
|
||
|
|
<li>All distribution objects (mail)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The documents saved are not in any folder. FLR(*NONE) is valid only when one of the following is specified:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*ALL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) SRCHTYPE(*DOC)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-folder-name</i></b></dt>
|
||
|
|
<dd>Specify a generic name. 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 objects 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 object name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>folder-name</i></b></dt>
|
||
|
|
<dd>Specify the user-assigned name of the folder in which the documents to be saved are located. The folder name can be a maximum of 63 characters in length.
|
||
|
|
<ul>
|
||
|
|
<li>Folder objects specified here are saved only when DLO(*ALL) or DLO(*FLRLVL) is specified.
|
||
|
|
</li>
|
||
|
|
<li>FLR(<i>folder-name</i>) is not valid when one of the following is specified:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*SYSOBJNAM)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*MAIL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) SRCHTYPE(*ALL)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Only one folder name can be specified when one of the following is specified:
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*DOCL)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) SRCHTYPE(*DOC)
|
||
|
|
</li>
|
||
|
|
<li>DLO(<i>document-name</i>)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>System object name is not supported.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.OMITFLR"></a>
|
||
|
|
<h3>Folders to omit (OMITFLR)</h3>
|
||
|
|
<p>Specifies the names of one of more folders, or the generic names of each group of folders, to be excluded from the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No folders are excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-folder-name</i></b></dt>
|
||
|
|
<dd>Specify a generic name. 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 folders 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 folder name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>folder-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the folder to be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>System object name is not supported.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.SRCHTYPE"></a>
|
||
|
|
<h3>Search type (SRCHTYPE)</h3>
|
||
|
|
<p>Specifies the type of objects for which to search. This parameter is valid only if *SEARCH is specified for the <b>Document library object (DLO)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DOC</u></b></dt>
|
||
|
|
<dd>Only documents are to be searched and saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Documents and folders are to be searched and saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.CHKEXP"></a>
|
||
|
|
<h3>Expiration date (CHKEXP)</h3>
|
||
|
|
<p>Specifies that all documents with an expiration date before the specified date are to be saved. The expiration date is assigned by the user when a document is created to specify when the document is no longer needed. This parameter is valid only when *SEARCH is specified for the <b>Document library object (DLO)</b> parameter and *DOC is specified for the <b>Search type (SRCHTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The expiration date is ignored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>All documents with an expiration date before today's date are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify a document expiration date. All documents with an expiration date before this date are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.CRTDATE"></a>
|
||
|
|
<h3>Creation date (CRTDATE)</h3>
|
||
|
|
<p>Specifies that documents and folders that have a creation date during the time period specified are to be saved. The time period is specified by a starting time and date and an ending time and date. This parameter is valid only when *SEARCH is specified for the <b>Document library object (DLO)</b> parameter. The time period is specified as follows:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
((start-time start-date) (end-time end-date))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Starting time and date</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 1: Starting time</b>
|
||
|
|
</p>
|
||
|
|
<p>Use one of the following to specify the starting time. Documents must have been created after this time to be selected. Documents created before this time are not selected.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Documents and folders filed at any time are eligible for saving.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the starting time. When the starting time is used as a search value, the starting date must not be *BEGIN. The starting-time must be the same as the value specified for the <b>Last changed time (REFCHGTIME)</b> parameter when the REFCHGTIME parameter is specified. The time can be specified with or without a time separator:
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 2: Starting date</b>
|
||
|
|
</p>
|
||
|
|
<p>Use one of the following to specify the starting date. Documents must have been created on or after this date to be saved. Documents created before this date are not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BEGIN</u></b></dt>
|
||
|
|
<dd>Documents and folders are saved regardless of the creation date associated with the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>Only documents and folders filed on today's date, after the starting time (if specified), are selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify a starting date for the document creation date time period. The date must be entered in the job date format. The start date must be the same as the value specified for the <b>Last changed date (REFCHGDATE)</b> parameter when the REFCHGDATE parameter is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Ending time and date</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 1: Ending time</b>
|
||
|
|
</p>
|
||
|
|
<p>Use one of the following to specify the ending time. Documents must have been created before this time to be saved. Any documents created after the specified time are not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Documents and folders filed at any time are selected for saving.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the ending time. When the ending time is to be used as a search value, the ending date must not be *END. See the description of <i>starting-time</i> for details about how time can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 2: Ending date</b>
|
||
|
|
</p>
|
||
|
|
<p>Use one of the following to specify the ending date. Documents must have been created on or before this date to be saved. Documents created after this date are not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>Documents and folders filed on any date are selected. The ending time is not allowed when *END is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the ending date for the document creation date time period. Documents created on or before this date are saved. The date must be specified in job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.DOCCLS"></a>
|
||
|
|
<h3>Document class (DOCCLS)</h3>
|
||
|
|
<p>Specifies the class of documents to be saved. The class is assigned by the user when the document is created. This parameter is valid only when *SEARCH is specified for the <b>Document library object (DLO)</b> parameter and *DOC is specified for the <b>Search type (SRCHTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Although document classes are user-assigned, double-byte character set (DBCS) data cannot be specified on this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>The document class is not used to select documents for saving.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the document class, ranging from 1 through 16 characters, used to select documents for saving.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.OWNER"></a>
|
||
|
|
<h3>Owner profile (OWNER)</h3>
|
||
|
|
<p>Specifies the owner of the documents and folders to be saved. This parameter is valid only when *SEARCH is specified for the <b>Document library object (DLO)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>Documents and folders owned by the current requester are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>This parameter is not used to select documents and folders for saving. You must have all object (*ALLOBJ) or save system (*SAVSYS) special authority if *ALL is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the user profile that owns the documents and folders to be saved. All documents and folders owned by this user and that meet the other search values specified are saved. *ALLOBJ or *SAVSYS special authority is required if a user profile is selected other than the user profile of the user issuing this command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.REFCHGDATE"></a>
|
||
|
|
<h3>Last changed date (REFCHGDATE)</h3>
|
||
|
|
<p>Specifies the date after which the folders that are created and the documents that are changed or created are to be saved. The change date is updated when the document content or description is changed. This parameter is valid only when *SEARCH is specified for the <b>Document library object(DLO)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>No reference change date is specified. Documents are saved regardless of the date they were created or changed. Folders are saved regardless of the date they were created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SAVDLOALL</b></dt>
|
||
|
|
<dd>Folders that have been created and documents created or changed since that last complete save operation are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date after which the created folders or the created or changed documents are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.REFCHGTIME"></a>
|
||
|
|
<h3>Last changed time (REFCHGTIME)</h3>
|
||
|
|
<p>Specifies the time, relative to the date specified for the REFCHGDATE parameter, after which the folders that are created and the documents that are changed or created are to be saved. The change time is updated when the document content or description is changed. This parameter is valid only when *SEARCH is specified for the <b>Document library object (DLO)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>No time is specified. The documents are saved regardless of the time they were created or changed. Folders are saved regardless of the time they were created.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the time after which the created folders or the created or changed documents are saved.
|
||
|
|
<p>The time can be specified with or without a time separator:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.DOCL"></a>
|
||
|
|
<h3>Document list (DOCL)</h3>
|
||
|
|
<p>Specifies a list of documents to be saved. The document list must be in a folder. The name of the folder must be specified using the <b>Folder (FLR)</b> parameter. You must have use (*USE) authority to the folders containing the documents in the document list.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A document list must be the result of a local search, not a remote search.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No document list is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the document list to be saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.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="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.STG"></a>
|
||
|
|
<h3>Storage (STG)</h3>
|
||
|
|
<p>Specifies whether system storage occupied by the document being saved is kept, deleted, or freed after the save operation ends.
|
||
|
|
</p>
|
||
|
|
<p><b>Note:</b> STG(*DELETE) and STG(*FREE) are not valid when any of the following are specified:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>DLO(*ALL) FLR(*ANY)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*SEARCH) CHKFORMRK(*YES)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*CHG)
|
||
|
|
</li>
|
||
|
|
<li>DLO(*MAIL)
|
||
|
|
</li>
|
||
|
|
<li>SAVACT(*YES)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*KEEP</u></b></dt>
|
||
|
|
<dd>The storage occupied by the document remains unchanged after the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DELETE</b></dt>
|
||
|
|
<dd>The document object and all search terms are deleted from the system after the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FREE</b></dt>
|
||
|
|
<dd>The document description and search terms remain on the system but the storage occupied by the document is deleted after the save operation. The document cannot be used until the document is restored to the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.CMDCHRID"></a>
|
||
|
|
<h3>Command character identifier (CMDCHRID)</h3>
|
||
|
|
<p>Specifies the character identifier (graphic character set and code page) for the data specified for the <b>Document class (DOCCLS)</b> parameter. The character identifier is related to the display device used to enter the document class.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
|
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Graphic character set</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the graphic character set to use.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Code page</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the code page to use.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.SAVACT"></a>
|
||
|
|
<h3>Save active (SAVACT)</h3>
|
||
|
|
<p>Specifies whether an object can be updated while it is being saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Document library objects in use are not saved. Document library objects cannot be updated while being used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Document library objects can be changed during the save request.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Some applications update document library objects directly. The data is supplied to the application rather than saving the updates in a temporary file and then updating the DLOs. DLOs that are being updated directly (typically, those being updated by PC-based applications) will not be saved. See the Backup and Recovery information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information on using this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.SAVACTWAIT"></a>
|
||
|
|
<h3>Save active wait time (SAVACTWAIT)</h3>
|
||
|
|
<p>Specifies the amount of time for an object that is in use, before continuing the save operation. 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 to become available 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 before continuing the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.ASP"></a>
|
||
|
|
<h3>ASP number (ASP)</h3>
|
||
|
|
<p>Specifies the number of the auxiliary storage pool (ASP) of the document library object (DLO) to be saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANY</u></b></dt>
|
||
|
|
<dd>The objects to be saved reside in any ASP. When DLO(*ALL) FLR(*ANY) are specified, all document library objects on the system are saved.
|
||
|
|
<p><b>Note:</b>When DLOs from multiple ASPs are saved, multiple tape media files are created. The beginning and ending sequence numbers of these media files will be required on the RSTDLO command to restore all ASPs.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the number of an existing ASP that contains the document library objects to be saved. ASP 1 is the system ASP.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Mail that has not been filed and documents that are not in a folder reside in the system ASP.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.NEWOBJ"></a>
|
||
|
|
<h3>Object name generation (NEWOBJ)</h3>
|
||
|
|
<p>Specifies whether a new library-assigned name and system object name are generated for the folders and documents that are restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The library-assigned name and system object name do not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEW</b></dt>
|
||
|
|
<dd>A new library-assigned name and system object name are generated for each document or folder that is restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.ALWOBJDIF"></a>
|
||
|
|
<h3>Allow object differences (ALWOBJDIF)</h3>
|
||
|
|
<p>Specifies whether the following differences encountered during a restore operation are allowed.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Ownership--the owner of the object on the system is different than the owner of the object from the save operation.
|
||
|
|
</li>
|
||
|
|
<li>System object name--the system object name on the system does not match the system object name on the media.
|
||
|
|
</li>
|
||
|
|
<li>Authorization list linking--the object is being restored to a system different from the one on which it was saved.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The ALWOBJDIF parameter can be used to allow an object to be restored whose owner or object name on the system is different than on the media used for the restore operation. By specifying the *ALL special value, an object with a different name is restored to the name on the media, while an object with a different owner keeps the owner name from the system instead of the media.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To use this parameter, you need all object (*ALLOBJ) authority.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>None of the differences described above are allowed on the restore operation. For authorization list cases, the object is restored, but the object is not linked to the authorization list, and public authority is set to *EXCLUDE. For other cases, a diagnostic message is sent for the object, and the object is not restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All of the differences described above are allowed for the restore operation. An informational message is sent, and the object is restored.
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If the owners of the object do not match, the object is restored, but it will keep the ownership and authorities of the object on the system before the restore operation.
|
||
|
|
</li>
|
||
|
|
<li>If *ALL is specified on this parameter, *NEW cannot be specified for the <b>Object name generation (NEWOBJ)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>If you are restoring objects to a system different from the one on which they were saved and the objects are secured by an authorization list, specifying *ALL automatically links the objects to the authorization list. If the authorization list does not exist on the new system, a message that includes the name of the missing list is issued.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVRSTDLO.RSTASP"></a>
|
||
|
|
<h3>Restore to ASP number (RSTASP)</h3>
|
||
|
|
<p>Specifies the number of the auxiliary storage pool (ASP) on media in which restored documents and folders are to be placed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVASP</u></b></dt>
|
||
|
|
<dd>The documents and folders are placed in the same ASP from which they were saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the number of the ASP in which restored documents and folders are placed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVRSTDLO.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving and Restoring All Document Library Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVRSTDLO DLO(*ALL) RMTLOCNAME(SYSTEM1) FLR(*ANY)
|
||
|
|
SAVACT(*YES) NEWOBJ(*NEW)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all document library objects located in any folder and restores the objects to a remote system named SYSTEM1. The objects can be changed during the save and restore operation and new names will be given to the libraries in which the objects are restored.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Saving and Restoring Specific Document Library Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVRSTDLO DLO(*SEARCH) RMTLOCNAME(SYSTEM2) FLR(FLR2)
|
||
|
|
OWNER(USER8) SRCHTYPE(*DOC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command searches for a folder named FLR2 and checks to see if the documents owned by user USER8. The folder and the documents in the folder are saved and restored on a remote system named SYSTEM2.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVRSTDLO.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPCAD82</b></dt>
|
||
|
|
<dd>&1 document library objects saved and restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFAD8C</b></dt>
|
||
|
|
<dd>An error occurred during the SAVRSTDLO 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="#SAVRSTDLO.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|