1632 lines
78 KiB
HTML
1632 lines
78 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 Library using BRM (SAVLIBBRM)</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="SAVLIBBRM.Top_Of_Page"></a>
|
||
|
|
<h2>Save Library using BRM (SAVLIBBRM)</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="#SAVLIBBRM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVLIBBRM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVLIBBRM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVLIBBRM"></a>
|
||
|
|
<p>The Save Library using BRM (SAVLIBBRM) command saves a copy of one or more libraries.
|
||
|
|
</p>
|
||
|
|
<p>This command saves the entire library, including the library description, the object descriptions, and the contents of the objects in the library.
|
||
|
|
</p>
|
||
|
|
<p>For job queues, message queues and logical files, only the object definitions are saved, not the contents. The contents of output queues can be saved using SPLFDTA(*ALL), otherwise, only the output queue object definition is saved. The contents of save files can be saved using SAVFDTA(*YES), otherwise, only the save file object definition is saved.
|
||
|
|
</p>
|
||
|
|
<p>Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The <b>Device (DEV) </b>parameter is limited on only one device or *MEDCLS special value for serial operations.
|
||
|
|
</li>
|
||
|
|
<li>Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE authority is required to the image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>Execute (*X) authority is required to each directory in the image catalog path name.
|
||
|
|
</li>
|
||
|
|
<li>Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
|
||
|
|
</li>
|
||
|
|
<li>*USE authority is required to the virtual devices using the image catalogs.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions: </b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have authority to the SAVLIB or SAVCHGOBJ commands to use this command.
|
||
|
|
</li>
|
||
|
|
<li>You must have *USE authority to any auxiliary storage pool device specified for the <b>Auxiliary storage pool (ASPDEV)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>You must have either the *SAVSYS special authority or you must have:
|
||
|
|
<ul>
|
||
|
|
<li>Read authority for, or be the owner of, each library specified.
|
||
|
|
</li>
|
||
|
|
<li>Object existence authority for each object in the library.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>When saving to a save file, only one library can be specified.
|
||
|
|
</li>
|
||
|
|
<li>No library (or object in the library) being saved can be updated by a job that is running at the same time the save operation occurs unless save-while-active is used.
|
||
|
|
</li>
|
||
|
|
<li>*NONE must be specified for the <b>Spooled file data (SPLFDTA)</b> parameter if the value for the <b>Target release (TGTRLS)</b> parameter resolves to a release prior to V5R4M0. Use backup spooled file lists to save of spooled files for restore to target releases prior to V5R4M0.
|
||
|
|
</li>
|
||
|
|
<li>*NONE must be specified for the SPLFDTA parameter if the value for the <b>Save type (SAVTYPE)</b> parameter is *CUML or *INCR.
|
||
|
|
</li>
|
||
|
|
<li>This command should not be used by control group *EXIT item processing as results will be unpredictable.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>You can save data to a Tivoli Storage Manager (TSM) server using this command. To save data to a TSM server, the following conditions must be met:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Only user data can be saved to TSM servers. BRMS does not allow *IBM type libraries to be saved TSM servers. Also, BRMS does not allows IBM supplied libraries that are considered user data such as QGPL, QUSRBRM, or QUSRSYS libraries to be saved TSM media.
|
||
|
|
</li>
|
||
|
|
<li>You can only specify only one device for the <b>Device (DEV)</b> parameter and this device must be of category *NET or *APPC.
|
||
|
|
</li>
|
||
|
|
<li>You can specify DEV(*MEDCLS) with the <b>Location (LOC)</b> parameter to identify the *NET or *APPC category device to be used.
|
||
|
|
</li>
|
||
|
|
<li>You can specify a media policy name for the <b>Media policy (MEDPCY)</b> parameter if the media policy uses specifies *ADSM (TSM server) for the <b>Media class</b> attribute. Alternately you can specify MEDPCY(*NONE) in which can you must also specify *ADSM for the <b>Media class (MEDCLS)</b>, <b>Move policy (MOVPCY)</b> and <b>Secure volume (VOLSEC)</b> parameters.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Sequence number (SEQNBR)</b> parameter must be *END.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Save to save file (SAVF)</b>, <b> Mark volumes for duplication (MARKDUP)</b> and <b> Mark history for duplication (MARKHST)</b> parameters must be *NO. If *MEDPCY is specified for these parameters, then the respective value for the <b>Save to save file</b> attribute, <b>Mark volumes for duplication</b> attribute and <b>Mark history for duplication</b> attribute of the media policy specified by the <b>Media policy (MEDPCY)</b> parameter must be *NO.
|
||
|
|
</li>
|
||
|
|
<li>The <b>Required volumes (MINVOL)</b> parameter must be *NONE. If SAVF(*MEDPCY) is specified then the value for the <b>Required volumes </b> attribute of the media policy specified by the <b>Media policy (MEDPCY)</b> parameter must be *NONE.
|
||
|
|
</li>
|
||
|
|
<li>If *SYNCLIB is specified for the <b>Save active (SAVACT)</b> parameter each library is saved individually rather than as a group. Synchronization messages are therefore sent individually for each library rather than for the libraries as a group and synchronization is only within one library, not across libraries.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVLIBBRM.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="#SAVLIBBRM.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top">Single values: *ALLPROD, *ALLTEST, *ASP01, *ASP02, *ASP03, *ASP04, *ASP05, *ASP06, *ASP07, *ASP08, *ASP09, *ASP10, *ASP11, *ASP12, *ASP13, *ASP14, *ASP15, *ASP16, *ASP17, *ASP18, *ASP19, *ASP20, *ASP21, *ASP22, *ASP23, *ASP24, *ASP25, *ASP26, *ASP27, *ASP28, *ASP29, *ASP30, *ASP31, *ASP32, *ALLUSR, *IBM<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="#SAVLIBBRM.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Single values: *NONE<br>Other values (up to 4 repetitions): <i>Name</i>, *MEDCLS</td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MEDPCY"><b>MEDPCY</b></a></td>
|
||
|
|
<td valign="top">Media policy</td>
|
||
|
|
<td valign="top"><i>Name</i>, *NONE, *SYSPCY</td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIBBRM.PRLRSC"><b>PRLRSC</b></a></td>
|
||
|
|
<td valign="top">Parallel device resources</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Minimum resources</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32, <b><u>*NONE</u></b>, *AVAIL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Maximum resources</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-32, <b><u>*MIN</u></b>, *AVAIL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVACT"><b>SAVACT</b></a></td>
|
||
|
|
<td valign="top">Save active</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *LIB, *SYSDFN, *SYNCLIB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#SAVLIBBRM.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="#SAVLIBBRM.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="#SAVLIBBRM.OBJDTL"><b>OBJDTL</b></a></td>
|
||
|
|
<td valign="top">Retain object detail</td>
|
||
|
|
<td valign="top"><b><u>*ERR</u></b>, *MBR, *NO, *OBJ, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.CTLGRP"><b>CTLGRP</b></a></td>
|
||
|
|
<td valign="top">Control group</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *ARCGRP, *BKUGRP, *SYSGRP, *SYSTEM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVTYPE"><b>SAVTYPE</b></a></td>
|
||
|
|
<td valign="top">Type of save</td>
|
||
|
|
<td valign="top"><b><u>*FULL</u></b>, *CUML, *INCR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.ENDOPT"><b>ENDOPT</b></a></td>
|
||
|
|
<td valign="top">End of tape option</td>
|
||
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.USEOPTBLK"><b>USEOPTBLK</b></a></td>
|
||
|
|
<td valign="top">Use optimum block size</td>
|
||
|
|
<td valign="top"><b><u>*BKUPCY</u></b>, *DEV, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SEQNBR"><b>SEQNBR</b></a></td>
|
||
|
|
<td valign="top">Sequence number</td>
|
||
|
|
<td valign="top">1-16777215, <b><u>*END</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*CURRENT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.CLEAR"><b>CLEAR</b></a></td>
|
||
|
|
<td valign="top">Clear</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *AFTER, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.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="#SAVLIBBRM.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="#SAVLIBBRM.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.COMPACT"><b>COMPACT</b></a></td>
|
||
|
|
<td valign="top">Data compaction</td>
|
||
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVFDTA"><b>SAVFDTA</b></a></td>
|
||
|
|
<td valign="top">Save contents of save files</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SPLFDTA"><b>SPLFDTA</b></a></td>
|
||
|
|
<td valign="top">Spooled file data</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.REFDATE"><b>REFDATE</b></a></td>
|
||
|
|
<td valign="top">Reference date</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*REF</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.REFTIME"><b>REFTIME</b></a></td>
|
||
|
|
<td valign="top">Reference time</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*REF</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.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="#SAVLIBBRM.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="#SAVLIBBRM.OMITLIB"><b>OMITLIB</b></a></td>
|
||
|
|
<td valign="top">Libraries to omit</td>
|
||
|
|
<td valign="top">Single values: <b><u>*BKUPCY</u></b>, *NONE<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="#SAVLIBBRM.OMITOBJ"><b>OMITOBJ</b></a></td>
|
||
|
|
<td valign="top">Objects to omit</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Object type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">Auxiliary storage pool</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SYSBAS</u></b>, *CURASPGRP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.EXPDATE"><b>EXPDATE</b></a></td>
|
||
|
|
<td valign="top">Expiration date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*MEDPCY</u></b>, *PERM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MOVPCY"><b>MOVPCY</b></a></td>
|
||
|
|
<td valign="top">Move policy</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*MEDPCY</u></b>, *ADSM, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MEDCLS"><b>MEDCLS</b></a></td>
|
||
|
|
<td valign="top">Media class</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*MEDPCY</u></b>, *ADSM, *SYSPCY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.LOC"><b>LOC</b></a></td>
|
||
|
|
<td valign="top">Location</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*MEDPCY</u></b>, *ANY, *HOME</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVF"><b>SAVF</b></a></td>
|
||
|
|
<td valign="top">Save to save file</td>
|
||
|
|
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVFASP"><b>SAVFASP</b></a></td>
|
||
|
|
<td valign="top">Save file ASP</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*MEDPCY</u></b>, *SYSTEM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.SAVFEXP"><b>SAVFEXP</b></a></td>
|
||
|
|
<td valign="top">Retain save files</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*MEDPCY</u></b>, *NONE, *PERM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MAXSTG"><b>MAXSTG</b></a></td>
|
||
|
|
<td valign="top">ASP storage limit</td>
|
||
|
|
<td valign="top">1-99, <b><u>*MEDPCY</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.VOLSEC"><b>VOLSEC</b></a></td>
|
||
|
|
<td valign="top">Secure volume</td>
|
||
|
|
<td valign="top"><b><u>*MEDPCY</u></b>, *ADSM, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MINVOL"><b>MINVOL</b></a></td>
|
||
|
|
<td valign="top">Required volumes</td>
|
||
|
|
<td valign="top">1-9999, <b><u>*MEDPCY</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MARKDUP"><b>MARKDUP</b></a></td>
|
||
|
|
<td valign="top">Mark volumes for duplication</td>
|
||
|
|
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIBBRM.MARKHST"><b>MARKHST</b></a></td>
|
||
|
|
<td valign="top">Mark history for duplication</td>
|
||
|
|
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVLIBBRM.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies which libraries are saved to removable media or to a save file.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you specify *ALLUSR or *IBM on this parameter, this command should be run when the specified libraries are not being used. If objects in a library are in use while the library is being saved, the objects are not saved unless you use SAVACT. To ensure a complete save of all libraries, run this command with the systems in a restricted state. For example, if SAVLIBBRM LIB(*ALLUSR) is run when the subsystem QSNADS is active the QAO* files are not saved in library QUSRSYS. To save the QAO* files, end the QSNADS subsystem before running SAVLIBBRM LIB(*ALLUSR).
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Doing a SAVLIBBRM LIB(*IBM) and then doing a SAVLIBBRM LIB(*ALLUSR) saves the same libraries as a SAVLIB LIB(*NONSYS), but requires two restore commands.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions: </b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The value *IBM is not valid on the <b>Library (LIB)</b> parameter when *SYNCLIB is specified on the <b>Save active (SAVACT)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>A value other than *CURRENT cannot be specified for the <b>Target release (TGTRLS)</b> parameter when *ALLUSR or *IBM is specified for the <b>Library (LIB)</b> parameter.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLPROD</b></dt>
|
||
|
|
<dd>Saves all libraries with an *PROD attribute. If you save both *ALLPROD and *ALLTEST, it is equivalent to saving *ALLUSR.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLTEST</b></dt>
|
||
|
|
<dd>Saves all libraries with an *TEST attribute. If you save both *ALLTEST and *ALLPROD, it is equivalent to saving *ALLUSR.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASPnn</b></dt>
|
||
|
|
<dd>The system (1) or basic user auxiliary storage pool (2-32) that you want to save. For example: to save libraries in ASP 2, enter *ASP02.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When you specify ASPnn, only libraries in the specified basic user auxiliary storage pool are included. No other object types are included.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The usage of ASPnn applies only to system (1) or basic auxiliary storage pools. Support is not provided for auxiliary storage pools that contain only individual objects such as save files, journals, or journal receivers.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The usage of ASPnn does not support UDFS, primary, or secondary auxiliary storage pools.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>The special value *ALLUSR saves all user libraries.
|
||
|
|
<p>Refer to the Special Values table for the Save Library (SAVLIB) Command in the Saving Libraries section of the iSeries Backup and Recovery book for a list of libraries which can be restored using this special value.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Libraries QGPL, QUSRSYS and QUSRBRM will be omitted in an *ALLUSR save to a TSM (ADSM) server.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IBM</b></dt>
|
||
|
|
<dd>The special value *IBM saves all system (IBM) libraries.
|
||
|
|
<p>Refer to the Special Values table for the Save Library (SAVLIB) Command in the Saving Libraries section of the iSeries Backup and Recovery book for a list of libraries which can be restored using this special value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the names of a maximum of 300 libraries to be saved. The libraries QSYS, QSRV, QTEMP, QSPL, QSPLxxxx, QDOC, QDOCxxxx, QRPLOBJ, and QRECOVERY cannot be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-name</i></b></dt>
|
||
|
|
<dd>Specify one or more generic names of groups of libraries that you want to save. 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 library name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the device or devices to be used by this command.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDCLS</b></dt>
|
||
|
|
<dd>Devices for this policy or control group are selected based on device types that support the density for the media class specified in the media policy. The *MEDCLS special value is used for devices that are part of a device pool, such as several systems that share a single or set of devices. Devices are specified in the Work with Devices display.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you want to use more than one device for a serial save operation, the *MEDCLS can be repeated up to four times, once for each device used, except for virtual tape devices which is limited to a single value. The Parallel Device Resource (PRLRSC) parameter must be *NONE. BRMS will attempt to use the maximum number of devices that can be allocated for a save operation. If you want to use more than one device for a parallel save operation the *MEDCLS must only be specified once and the PRLRSC minimum and maximum responses must be greater than one.
|
||
|
|
</p>
|
||
|
|
<p><b>Other values (up to 4 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the name of the devices to be used for the save operation. the specified device name must already be in the BRMS device table.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more" and press the Enter key.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Multiple systems can share the use of a tape device or a media library device (MLB). When the device is a tape device (not an MLB device), BRMS can help you manage the use of the stand alone device by multiple systems if you indicate the device is shared.
|
||
|
|
</p>
|
||
|
|
<p>You can save data to a TSM (ADSM) server using this command. You can only specify one TSM type server in the list of devices or *MEDCLS, which must select a TSM server. The device type can either be *APPC, which supports SNA network protocol, or *NET, which supports TCPIP protocol.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There is no device for this save operation. Save files are used to store the saved data. Data in a save file created with device *NONE will never be copied by BRMS. It is intended for online access only.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name</i></b></dt>
|
||
|
|
<dd>Specify the names of one or more devices used for the save operation. If you are using more than one device (up to a maximum of four), specify the names of the devices in the order in which they are used.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When doing a serial save, only one media library device or one virtual tape device can be specified. When doing a parallel save, multiple media library devices or virtual tape devices can be specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>PRLRSC must be *NONE when DEV is *NONE.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When doing a serial save, only one media library device or one virtual tape device can be specified. When doing a parallel save, multiple media library devices or virtual tape devices can be specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MEDPCY"></a>
|
||
|
|
<h3>Media policy (MEDPCY)</h3>
|
||
|
|
<p>Specifies the media policy to be used with this save command.
|
||
|
|
</p>
|
||
|
|
<p>Media policies are used to determine:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The type of retention to use, such as days, date or version, for media used in control group processing.
|
||
|
|
</li>
|
||
|
|
<li>The move policy to use with this media policy.
|
||
|
|
</li>
|
||
|
|
<li>The media class to use.
|
||
|
|
</li>
|
||
|
|
<li>Whether or not to use save files.
|
||
|
|
</li>
|
||
|
|
<li>The type of retention to use, such as days or date for save files created in control group processing.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The media policy you specify must be a media policy that is in the BRMS media policy table.
|
||
|
|
</p>
|
||
|
|
<p>This a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSPCY </u></b></dt>
|
||
|
|
<dd>The media policy specified in the system policy is assigned to output volumes from this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No media policy is specified for this save operation. Media policy values must be supplied with the save command for each parameter that has a default of *MEDPCY.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you specify *NONE, and you are saving data to a TSM (ADSM) server, you must specify the *ADSM special value in the MOVPCY, MEDCLS and VOLSEC parameters which are part of the media policy values for this save operation. You must still supply the additional media policy values for the remaining parameters with *MEDPCY as the default. The TSM management class STANDARD, and the TSM node *LCL, are used as default values for the save operation.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>media-policy</i></b></dt>
|
||
|
|
<dd>Specify the name of the media policy that you want to use with this save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.PRLRSC"></a>
|
||
|
|
<h3>Parallel device resources (PRLRSC)</h3>
|
||
|
|
<p>Specifies the minimum and maximum number of device resources to be used in a parallel save operation.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Transferring save files to tape does not support parallel operations.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Minimum Resources</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the minimum number of device resources required for a parallel save.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If a Media Library Device (MLB) is being used and the required resources are not available, the command will wait for the MLB to become available for a time period specified by the user. The wait time is determined by the value specified on the *MLB device description for INLMNTWAIT. If a *TAP device is being used and the required resources are not available, the command will fail.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No device resources are to be used. The save will be performed as a serial save. *NONE must be specified when using a TSM or virtual tape device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AVAIL</b></dt>
|
||
|
|
<dd>Use any available devices up to the maximum of what was used for a save. Specifying this value for the minimum will allow BRMS to use any available resources, but will complete using one resource if only one is available at the start of the command.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the minimum number of device resources to be used with this save command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Maximum Resources</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the maximum number of device resources.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MIN</u></b></dt>
|
||
|
|
<dd>Uses the value specified for the minimum number of device resources.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AVAIL</b></dt>
|
||
|
|
<dd>Use any available devices for the save operation. Specifying this value for the maximum will allow BRMS to use any available resources but at a minimum the value specified in the minimum element.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of device resources to be used with this save command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVACT"></a>
|
||
|
|
<h3>Save active (SAVACT)</h3>
|
||
|
|
<p>Specifies if 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>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you are using the MONSWABRM command as part of an *EXIT special operation in a control group, the <b>Save while active </b>field must have a value of *YES for the entry that you want to save while active. The Monitor Save While Active (MONSWABRM) command reviews the save while active message queue and looks for the message indicating the end of library synchronization. When synchronization is detected, you can issue a command to the system.
|
||
|
|
</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 of the objects in a library reach a checkpoint together and are saved in a consistent state in relationship to each other.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Libraries with thousands of objects may be too large for this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYNCLIB</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. All of the objects and all of the libraries in the save operation reach a checkpoint together and are saved in a consistent state in relationship to each other.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Multiple checkpoints will occur when using *SYNCLIB with an incremental *ALLUSR backup item if new libraries were added to the system since the last save because synchronization is only within commands, not across libraries. New libraries are saved using Save Library (SAVLIB) command. Changed libraries are saved using the Save Changed Object (SAVCHGOBJ) command with a reference date and time that is the earliest occurance of either that last full or last incremental backup. BRMS uses its own reference dates rather than those in the object description information to protect incremental saves from being affected by native save operations.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The *SYNCLIB choice cannot be used for the *IBM save type.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the libraries are being saved to save files or to TSM servers, each library is saved individually rather than as a group. Synchronization messages are therefore sent individually for each library rather than for the libraries as a group and synchronization is only within one library, not across libraries.
|
||
|
|
</p>
|
||
|
|
</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.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Specifying this value eliminates some size restrictions and can allow a library to be saved that could not be saved with SAVACT(*LIB).
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.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>Specifies the amount of time to wait for the object to become available for each object that is in use. If an object remains in use for the specified time, the object is not saved.
|
||
|
|
</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>wait-time</i></b></dt>
|
||
|
|
<dd>Specifies the time (in seconds) to wait for each individual object lock before continuing the save operation. Valid values range from 0 through 99 999.
|
||
|
|
</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 prompt (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 on <b>Element 1</b> for commit boundaries for record changes.
|
||
|
|
</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 pending transactions.
|
||
|
|
<p>If you restore an object that was saved with pending 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 pending transactions to apply or remove the changes. Until you apply or remove the changes, any future save of that object will include the pending transactions, even if you do not specify *NOCMTBDY.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions: </b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The value of the <b>Target release (TGTRLS)</b> parameter must be *CURRENT, V5R3M0 or later release to use *NOCMTBDY.
|
||
|
|
</li>
|
||
|
|
<li>The value of the <b>Object detail (OBJDTL)</b> parameter must be *YES or *MBR to use *NOCMTBDY.
|
||
|
|
</li>
|
||
|
|
<li>The name of the saved library cannot begin with the letter <b>Q </b>or <b># </b> when using *NOCMTDBY.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>wait-time</i></b></dt>
|
||
|
|
<dd>Specifies the time (in seconds) to wait for transactions with pending record changes to reach a commit boundary. Valid values range from 0 through 99 999.
|
||
|
|
</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 <b>Add Commitment Resource (QTNADDCR) </b>API in the <b>System API Reference </b> information in the <b>iSeries Information Center </b>at <b>http://www.ibm.com/eserver/iseries/infocenter. </b>
|
||
|
|
</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 on <b>Element 1 </b>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>wait-time</i></b></dt>
|
||
|
|
<dd>Specifies the time (in seconds) to wait for the types of transactions that are listed above to reach a commit boundary. Valid values range from 0 through 99 999.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.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 the library is complete. A separate message is sent for each library to be saved when the *SYSDFN or *LIB value is specified on the <b>Save active (SAVACT)</b> parameter. When the *SYNCLIB value is specified on the <b>Save active (SAVACT)</b> parameter, one message is sent for all libraries in the save operation.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When multiple save operations are generated by BRMS, then one message is sent for each command generated.
|
||
|
|
</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>Qualifier 1: Save active message queue </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.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue that the notification message is sent to.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>The library list is used to locate the message queue.
|
||
|
|
</dd>
|
||
|
|
<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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Restrictions: </b> If MONSWABRM is used to monitor the save while active message queue, and LIB(*MSGQ) is specified for the MONSWABRM, the name specified here must match the name on the MSGQ parameter for the MONSWABRM command.
|
||
|
|
</p>
|
||
|
|
<p>MONSWABRM always uses the message queue from library QUSRBRM.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.OBJDTL"></a>
|
||
|
|
<h3>Retain object detail (OBJDTL)</h3>
|
||
|
|
<p>Specifies whether the object detail is kept in the BRMS database for the objects saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ERR</u></b></dt>
|
||
|
|
<dd>Error detail is kept in the BRMS backup history.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MBR</b></dt>
|
||
|
|
<dd>Object and member detail is kept in the BRMS backup history.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Member level information is included with the object information for physical files, and saved spooled file information is kept for saved output queues if *ALL was specified for the <b>Save spooled file data (SPLFDTA)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This choice is the same as *YES.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No object detail is kept in the BRMS backup history.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OBJ</b></dt>
|
||
|
|
<dd>Object detail is kept in the BRMS backup history. No member level information or saved spooled file information is kept.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Object detail is kept in the BRMS backup history.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When *YES is specified, member level information is kept for physical files in addition to object information, and saved spooled file information is kept for saved output queues if *ALL was specified for the <b>Save spooled file data (SPLFDTA)</b> parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.CTLGRP"></a>
|
||
|
|
<h3>Control group (CTLGRP)</h3>
|
||
|
|
<p>Specifies the name of the control group that you want to associate with the objects saved by this command. The control group name is stored with the media information and can be used with the <b>Control group (CTLGRP) </b>parameter on other BRMS commands to filter the media information or recover saved objects by control group.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>None of the attributes of the control group are used for the save.
|
||
|
|
</p>
|
||
|
|
<p>If you are using version control for the items you are saving, this save operation will be recorded as part of the specified version control. Version control is specified in the media policy associated with this control group and can be reviewed by using the Work with Media Policies display.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Do not specify a control group name for this command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ARCGRP</b></dt>
|
||
|
|
<dd>The name of the default archive control group.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BKUGRP</b></dt>
|
||
|
|
<dd>The name of the default backup control group used to save all user data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSGRP</b></dt>
|
||
|
|
<dd>The name of the default system control group used to save all system data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSTEM</b></dt>
|
||
|
|
<dd>The name of the default system control group used to save the entire system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-group-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the control group to be assigned to the items you are saving.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVTYPE"></a>
|
||
|
|
<h3>Type of save (SAVTYPE)</h3>
|
||
|
|
<p>Specifies whether all objects in a library are to be saved or only those objects that have changed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If a backup includes new libraries and BRMS has no history of a full backup of these libraries, then a full backup will be performed regardless of the type of incremental specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FULL</u></b></dt>
|
||
|
|
<dd>Save all objects in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CUML</b></dt>
|
||
|
|
<dd>Only save items that have changed. *CUML indicates that the incremental save includes all objects that have been changed since the last full save.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INCR</b></dt>
|
||
|
|
<dd>Only save changed items. *INCR indicates that the incremental save includes all objects that have been changed since the last incremental save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.ENDOPT"></a>
|
||
|
|
<h3>End of tape option (ENDOPT)</h3>
|
||
|
|
<p>Specifies, when tape is used, what positioning operation is automatically done on the volume after the save operation ends. If more than one volume is included, this parameter applies only to the last volume used; all other volumes are rewound and unloaded when the end of the volume is reached.
|
||
|
|
</p>
|
||
|
|
<p>If you specify *LEAVE and the device is a shared device, the device will not be varied off after the save operation. If you specify *LEAVE and the device is not a shared device, the device will be varied off after the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REWIND</u></b></dt>
|
||
|
|
<dd>The volume is automatically rewound, but not unloaded, after the operation has ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LEAVE</b></dt>
|
||
|
|
<dd>The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNLOAD</b></dt>
|
||
|
|
<dd>The volume is automatically rewound and unloaded after the operation ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.USEOPTBLK"></a>
|
||
|
|
<h3>Use optimum block size (USEOPTBLK)</h3>
|
||
|
|
<p>Specifies whether or not the optimum block size is used for the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BKUPCY</u></b></dt>
|
||
|
|
<dd>Use the value from the backup policy for the <b>Use optimum block size </b>parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEV</b></dt>
|
||
|
|
<dd>Use the value specified on the Work with Devices display for the <b>Use optimum block size </b>parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The optimum block size supported by the device is not used. Save commands use the default block size supported by all device types. The tape volume can be duplicated to any media format using the Duplicate Tape (DUPTAP) command or the Duplicate Media using BRM (DUPMEDBRM) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The optimum block size supported by the device is used for Save commands. If the block size used is larger than a block size that is supported by all device types then:
|
||
|
|
<ul>
|
||
|
|
<li>Performance may improve.
|
||
|
|
</li>
|
||
|
|
<li>The tape file that is created is only compatible with a device that supports the block size used. Commands such as Duplicate Tape (DUPTAP) and Duplicate Media using BRM (DUPMEDBRM) do not duplicate files unless the files are being duplicated to a device which supports the same block size that was used.
|
||
|
|
</li>
|
||
|
|
<li>The value for the Data Compression (DTACPR) parameter is ignored.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies, when tape is used, the sequence to use for the save operation. If you are saving to a BRMS volume that is expired, BRMS will begin writing information at the beginning of the volume, even though you have specified *END. If you are saving to a BRMS volume, BRMS will redirect the output to begin at the logical end of the output volume (after the end of the last active file), depending on the output device that you are using. For example, a 3490 device can write to any sequence number whereas a 6525 device can only write to sequence number 1 or *END.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>The save operation begins after the sequence number of the last active file on the volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>file-sequence-number</i> (1-16,777,215)</b></dt>
|
||
|
|
<dd>Specify the sequence number of the file to be used for the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release of the operating system on which you intend to restore the objects being saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The objects are to be restored on a system that is running the same release of the operating system currently running on your system. For example, if V5R2M0 is running on the system, *CURRENT means that you intend to restore the objects on a system with V5R2M0 installed. The objects can also be restored on a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The objects are to be restored on a system that is running on the previous release with modification level 0 of the operating system. For example if V5R2M0 is running on your system, *PRV means you intend to restore the objects on a system with V5R1M0 installed. The object can also be restored on a system with any subsequent release of the operating system installed.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Not all objects can be targeted to another release. Objects that are new to a release typically cannot be saved to a previous release.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>target-release</i></b></dt>
|
||
|
|
<dd>Specify the release in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R2M0 is version 5, release 2, modification level 0.
|
||
|
|
<p>The objects can be restored on a system with the specified release or with any subsequent release of the operating system installed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Not all objects can be targeted to another release. Objects that are new to a release typically cannot be saved to a previous release.
|
||
|
|
</p>
|
||
|
|
<p>Valid values depend on the current version, release, and modification level, and they change with each new release. If you specify a release-level that is earlier than the earliest release level supported by this command, an error message is sent indicating the earliest supported release.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.CLEAR"></a>
|
||
|
|
<h3>Clear (CLEAR)</h3>
|
||
|
|
<p>Specifies whether uncleared volumes or save files encountered during the save operation are automatically cleared.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>None of the uncleared volumes or save files encountered during the save operation are automatically cleared. If the save operation cannot proceed because an uncleared volume is encountered, an inquiry message is sent to the operator, allowing the ending of the save operation, or specifying that the currently selected volume be cleared so the operation can continue.
|
||
|
|
<p>If a save file is not cleared, the inquiry message is sent to the work station message queue for an interactive job, or to the operator for a batch job. All volumes used to perform the save operation should be cleared, or the save file must be empty, before the save command is issued.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AFTER</b></dt>
|
||
|
|
<dd>All the uncleared volumes after the initial volume are automatically cleared. This option is not valid for save or restore operations to a save file. If the operation cannot proceed because the first volume is uncleared, an inquiry message is sent to the system operator, allowing him to end the operation or to specify that the currently selected volume be cleared so the operation can continue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the uncleared volumes or save files encountered during the save operation are automatically cleared. If tapes are used and a sequence number is specified, the volume is cleared and, starting with that sequence number, all volumes following the first volume are cleared.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.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 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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.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 if all members on which the access paths are built are included in this save operation. 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 objects; it only controls the saving of the access paths. Information on the restoring of saved access paths is in the Backup and Recovery Book.
|
||
|
|
</p>
|
||
|
|
<p><b>Attention: </b>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 and the based-on physical files must be in the same library and must be saved at the same time.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
|
<dd>The system value QSAVACCPTH 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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies whether data compression is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. Otherwise, no data compression is performed.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *DEV is specified on both the <b>Data compression (DTACPR)</b> parameter and the <b>Data compaction (COMPACT)</b> parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
<p>If *YES is specified on the <b>Data compression (DTACPR)</b> parameter and *DEV is specified on the <b>Data compaction (COMPACT)</b> parameter, both device data compaction and device data compression are performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compression is performed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>If the target device supports compression, hardware compression is performed. if compression is not supported, software compression is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.COMPACT"></a>
|
||
|
|
<h3>Data compaction (COMPACT)</h3>
|
||
|
|
<p>Specifies whether data compaction is performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>Device data compaction is performed if the data is saved to tape and all devices specified on the <b>Device (DEV)</b> parameter support the compaction feature.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *DEV is specified on both the <b>Data compression (DTACPR)</b> parameter and the <b>Data compaction (COMPACT)</b> parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
<p>If *YES is specified on the <b>Data compression (DTACPR)</b> parameter and *DEV is specified on the <b>Data compaction (COMPACT)</b> parameter, both device data compaction and device data compression are performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compaction is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVFDTA"></a>
|
||
|
|
<h3>Save contents of save files (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 on the tape or in another save file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The description and contents of save files 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="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SPLFDTA"></a>
|
||
|
|
<h3>Spooled file data (SPLFDTA)</h3>
|
||
|
|
<p>Specifies whether to save the spooled file data and attributes for saved output queues. The saved spooled files and attributes can be viewed after the save using the Work with Saved Spooled Files (WRKSPLFBRM) command if *YES or *MBR is also specified for the <b>Retain object detail (OBJDTL) </b>parameter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Spooled file data is saved only when *FULL is specified for the <b>Type of save (SAVTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Specifies no spooled file data or attributes are saved with saved output queues.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Specifies all available spooled file data and attributes are saved with saved output queues.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.REFDATE"></a>
|
||
|
|
<h3>Reference date (REFDATE)</h3>
|
||
|
|
<p>Works in conjunction with an incremental (save changed objects) save performed under BRMS control.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REF</u></b></dt>
|
||
|
|
<dd>Uses the date of the last full BRMS save for this save operation as the beginning point for this incremental save.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>reference-date</i></b></dt>
|
||
|
|
<dd>Specify a date for this save operation to use as a beginning point for this incremental save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.REFTIME"></a>
|
||
|
|
<h3>Reference time (REFTIME)</h3>
|
||
|
|
<p>Works in conjunction with an incremental (save changed objects) save performed under BRMS control.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REF</u></b></dt>
|
||
|
|
<dd>Uses the time of the last full BRMS save for this save operation as the beginning point for this incremental save.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>reference-time</i></b></dt>
|
||
|
|
<dd>Specify a time in hour, minute, second (hhmmss) format for this save operation to use as a beginning point for this incremental save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.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 on the REFDATE and REFTIME 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>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The value entered applies only to save types of *INCR or *CUML. For save type *FULL, this value is always treated as *YES.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.STRLIB"></a>
|
||
|
|
<h3>Starting library (STRLIB)</h3>
|
||
|
|
<p>Specifies the library with which to begins the *IBM, *ALLUSR, *ALLPROD, *ALLTEST and *ASPnn save operations.
|
||
|
|
</p>
|
||
|
|
<p>If an irrecoverable media error occurs during the save operation, this parameter can be used to restart the operation.
|
||
|
|
</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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library with which to begin the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.OMITLIB"></a>
|
||
|
|
<h3>Libraries to omit (OMITLIB)</h3>
|
||
|
|
<p>Specifies the libraries to be excluded from the save operation. This parameter is valid only if *ALLUSR, *IBM or *ASPnn is specified on the <b>Library (LIB)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BKUPCY</u></b></dt>
|
||
|
|
<dd>The value specified for <b>Libraries to omit </b>field in the backup policy is used as the default value. The default value for <b>Libraries to omit (OMITLIB)</b> parameter is assigned in the backup policy.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No libraries are excluded.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-name</i></b></dt>
|
||
|
|
<dd>Specify the 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 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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be excluded. You can specify a maximum of 300 libraries.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.OMITOBJ"></a>
|
||
|
|
<h3>Object to omit (OMITOBJ)</h3>
|
||
|
|
<p>Specifies the objects to be excluded from the save operation. Up to 300 objects or generic object values can be specified.
|
||
|
|
</p>
|
||
|
|
<p>If the OMITOBJ parameter is not specified, no objects are excluded from the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No objects are excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Object </b>
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Object </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Objects in the specified libraries are excluded, depending on the value specified for the object type.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-object-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the object. A generic name is a character string of one or more characters followed by the 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>object-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the object that will be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The specified objects are excluded from all libraries that are part of the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-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 the 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>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library that contains the object to be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Object type </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All object types are excluded from the save operation, depending on the value specified for the object name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the type of the object to be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.ASPDEV"></a>
|
||
|
|
<h3>Auxiliary storage pool device (ASPDEV)</h3>
|
||
|
|
<p>Use this parameter to specify the auxiliary storage pools from which libraries and objects can be included in the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSBAS</u></b></dt>
|
||
|
|
<dd>Specifies libraries or objects from only the system (1) and basic user auxiliary storage pools (2-32) are included in the save.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURASPGRP</b></dt>
|
||
|
|
<dd>Specifies libraries or objects from only the auxiliary storage pool group currently set for the job are included in the save. Libraries or objects from the system (1) and basic user auxiliary storage pools (2-32) are omitted from the save.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>auxiliary-storage-pool-device-name</i></b></dt>
|
||
|
|
<dd>Specifies libraries or objects from the named auxiliary storage pool device are included in the save operation. This must be the name of a primary or secondary auxiliary storage pool. Libraries or objects from the system (1) and basic user auxiliary storage pools (2-32) are omitted from the save.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.EXPDATE"></a>
|
||
|
|
<h3>Expiration date (EXPDATE)</h3>
|
||
|
|
<p>Specifies the expiration that you want to use for output volumes created as a result of this save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PERM</b></dt>
|
||
|
|
<dd>Output volumes from this save operation are assigned a permanent expiration.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>expiration-date</i></b></dt>
|
||
|
|
<dd>Specify an expiration date with or without date separators that will be assigned to output volumes from this save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MOVPCY"></a>
|
||
|
|
<h3>Move policy (MOVPCY)</h3>
|
||
|
|
<p>Specifies the move policy that you want to use for output volumes created as a result of this save operation.
|
||
|
|
</p>
|
||
|
|
<p>If this save operation that you are performing is saving data to a device of category *NET or *APPC, you must specify the special value *ADSM (TSM server) for the MOVPCY parameter, since a TSM server controls the use of media in this case, not BRMS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADSM</b></dt>
|
||
|
|
<dd>Media movement is controlled by TSM server specifications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There is not a move policy associated with the output volumes that are created as a result of this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>move-policy</i></b></dt>
|
||
|
|
<dd>Specify a move policy that will be assigned to output volumes from this save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MEDCLS"></a>
|
||
|
|
<h3>Media class (MEDCLS)</h3>
|
||
|
|
<p>Specifies the media class that you want to use for selection of output volumes used in this save operation.
|
||
|
|
</p>
|
||
|
|
<p>If this save operation that you are performing is saving data to a device of category *NET or *APPC, you must specify the special value *ADSM (TSM server) for the MEDCLS parameter, since a TSM server controls the use of media in this case, not BRMS.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADSM</b></dt>
|
||
|
|
<dd>The save operation uses media that is selected and controlled by TSM server specifications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There is not a media class associated with the output volumes that are selected for this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSPCY</b></dt>
|
||
|
|
<dd>The value for the media class in the system policy will used to select output volumes for this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>media-class</i></b></dt>
|
||
|
|
<dd>Specify a media class that will be used to select output volumes for this save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.LOC"></a>
|
||
|
|
<h3>Location (LOC)</h3>
|
||
|
|
<p>Specifies the location that you want to use for selection of output volumes used in this save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>Volumes from any location are selected as output volumes for this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HOME</b></dt>
|
||
|
|
<dd>Volumes from the home location are selected as output volumes for this save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>location</i></b></dt>
|
||
|
|
<dd>Specify the location from which volumes are selected as output volumes for this save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVF"></a>
|
||
|
|
<h3>Save to save file (SAVF)</h3>
|
||
|
|
<p>Specifies whether the output from this save operation is saved to a save file.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the save operation that you are performing is saving data using media of class *ADSM (TSM server), you must specify *NO in this parameter. If you specify SAVF(*MEDPCY), then the value of the <b>Save to save file </b>field in the referenced media policy must be *NO.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy) (MEDPCY</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Output from this save operation is not saved to a save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Output from this save operation is saved to a save file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVFASP"></a>
|
||
|
|
<h3>Save file ASP (SAVFASP)</h3>
|
||
|
|
<p>Specifies the system (1) or basic user auxiliary storage pool (2-32) to which a save file is created as a result of this save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSTEM</b></dt>
|
||
|
|
<dd>The save file is saved to the system (1) auxiliary storage pool.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>save-file-ASP-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the auxiliary storage pool to which you are saving the save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>save-file-ASP-number</i></b></dt>
|
||
|
|
<dd>Specify the system (1) or basic user auxiliary storage pool number (2-32) for the save file that is created as a result of the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.SAVFEXP"></a>
|
||
|
|
<h3>Retain save files (SAVFEXP)</h3>
|
||
|
|
<p>Specifies how long save files are to be kept that are created as a result of this save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Save files generated from the save operation are not kept.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PERM</b></dt>
|
||
|
|
<dd>Save files generated from the save operation are kept permanently.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>expiration-date</i></b></dt>
|
||
|
|
<dd>Specify the date that indicates how long save files created from this save operation are to be kept.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MAXSTG"></a>
|
||
|
|
<h3>ASP storage limit (MAXSTG)</h3>
|
||
|
|
<p>Specifies the maximum percentage auxiliary storage pool (ASP) utilization that is acceptable during a save operation. For example, an entry of 90 would mean that a save process would continue until the auxiliary storage pool utilization exceeded 90%. If the upper limit is reached, the save process is stopped and a message sent to the BRMS log.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>storage-limit</i></b></dt>
|
||
|
|
<dd>Specify the maximum auxiliary storage pool utilization limit.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.VOLSEC"></a>
|
||
|
|
<h3>Secure volume (VOLSEC)</h3>
|
||
|
|
<p>Specifies whether you want to apply volume security to volumes in this media class. Volumes that are secured can only be read by users with the special authorities *ALLOBJ or *SAVSYS.
|
||
|
|
</p>
|
||
|
|
<p>If the save operation that you are performing is saving data to a device of category *NET or *APPC, you must specify the special value *ADSM (TSM server) for the VOLSEC parameter, since a TSM server controls volume security in this case, not BRMS
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADSM</b></dt>
|
||
|
|
<dd>Volume security is controlled by TSM server specifications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Volume security has not been applied to this media class. Volumes that do not have volume security can be read by anyone.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Only users with special authorities *ALLOBJ or *SAVSYS can read media volumes in this media class.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MINVOL"></a>
|
||
|
|
<h3>Require volumes (MINVOL)</h3>
|
||
|
|
<p>Specifies the minimum number of expired volumes that must be present before any save can be done using this media policy. The value can also be checked by user jobs using the Check Expired Media for BRM (CHKEXPBRM) command.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the save operation that you are performing is saving data using media of class *ADSM (TSM server), you must specify *NONE in this parameter. If you specify MINVOL(*MEDPCY), then the value of the <b>Required volumes </b>field in the referenced media policy must be *NONE.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There is no check done to determine the minimum number of required volumes before a save operation begins.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-volumes</i></b></dt>
|
||
|
|
<dd>Specify the number of expired media volumes that must be available before any BRMS save operation will begin. The number can range from 1 to 9999.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MARKDUP"></a>
|
||
|
|
<h3>Mark volumes for duplication (MARKDUP)</h3>
|
||
|
|
<p>Specifies whether media volumes will be marked for duplication. When *YES is selected, all volumes used during a save operation are marked for duplication. You can use VOL(*SEARCH) on the Duplicate Media using BRM command to duplicate the saved items after the save has completed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the save operation that you are performing is saving data using media of class *ADSM (TSM server), you must specify *NO in this parameter. If you specify MARKDUP(*MEDPCY), then the value of the <b>Mark for duplication </b>attribute in the referenced media policy must be *NO.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Volumes written to during a save operation will not be marked for duplication.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Volumes written to during the save operation will be marked for duplication.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIBBRM.MARKHST"></a>
|
||
|
|
<h3>Mark history for duplication (MARKHST)</h3>
|
||
|
|
<p>Specifies whether history items will be marked for duplication. When *YES is selected, all history items created during a save operation are marked for duplication. You must use VOL(*SCHHST) on the Duplicate Media using BRM command to duplicate the saved items.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the save operation that you are performing is saving data using media of class *ADSM (TSM server), you must specify *NO in this parameter. If you specify MARKHST(*MEDPCY), then the value of the <b>Mark history for duplication </b>attribute in the referenced media policy must be *NO.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MEDPCY</u></b></dt>
|
||
|
|
<dd>The value for this parameter is specified in the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this save command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>History items created during the save operation will not be marked for duplication.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>History items created during the save operation will be marked for duplication.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVLIBBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving a Library on a Tape Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIBBRM LIB(MYLIB) DEV(TAP01) MEDPCY(FULL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves library MYLIB to device TAP01 using the media policy FULL.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Saving a Generic Library on Multiple Devices</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIBBRM LIB(MY*) DEV(TAP01 TAP02) MEDPCY(FULL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all libraries that begin with the letters 'MY' to devices TAP01 and TAP02 using the media policy FULL.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Saving a Library on an Auxiliary Storage Pool Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIBBRM LIB(MYLIB) DEV(TAP01) MEDPCY(FULL) ASPDEV(PRIMETIME)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves library MYLIB which resides on auxiliary storage pool device PRIMETIME to device TAP01 using the media policy FULL.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVLIBBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>BRM1917</b></dt>
|
||
|
|
<dd>Feature not installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1921</b></dt>
|
||
|
|
<dd>Feature not licensed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM40A2</b></dt>
|
||
|
|
<dd>BRMS product initialization required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3700</b></dt>
|
||
|
|
<dd>All CPF37xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3800</b></dt>
|
||
|
|
<dd>All CPF38xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9800</b></dt>
|
||
|
|
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIBBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|