ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/savmedibrm.htm

867 lines
38 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 Media Info using BRM (SAVMEDIBRM)</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="SAVMEDIBRM.Top_Of_Page"></a>
<h2>Save Media Info using BRM (SAVMEDIBRM)</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="#SAVMEDIBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SAVMEDIBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SAVMEDIBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SAVMEDIBRM"></a>
<p>The Save Media Info using BRM (SAVMEDIBRM) command saves a copy of the information required to perform recovery of items saved using BRMS. Media information can be saved at the object or library level.
</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 SAVOBJ command to use this command.
</li>
<li>This command should not be used by control group *EXIT item processing as results will be unpredictable.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SAVMEDIBRM.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="#SAVMEDIBRM.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 1</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.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 2</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.OPTION"><b>OPTION</b></a></td>
<td valign="top">Option</td>
<td valign="top"><b><u>*LIB</u></b>, *OBJ</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.MOVPCY"><b>MOVPCY</b></a></td>
<td valign="top">Move policy</td>
<td valign="top"><i>Name</i>, <b><u>*MEDPCY</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.MEDCLS"><b>MEDCLS</b></a></td>
<td valign="top">Media class</td>
<td valign="top"><i>Character value</i>, <b><u>*MEDPCY</u></b>, *SYSPCY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.VOLSEC"><b>VOLSEC</b></a></td>
<td valign="top">Secure volume</td>
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SAVMEDIBRM.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the names of the devices used for save media information operation. Each device name must already be known on the system in the BRMS device table. If multiple devices are specified, they must use the same media classes. If more than one device is used, specify the names of the devices in the order in which they are used.
</p>
<p>This is a required parameter.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*MEDCLS</b></dt>
<dd>Any device that supports the media class specified in the media policy can be used for this save operation.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The save operation is to a save file.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the name of the device or devices that you want to use for this save operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.MEDPCY"></a>
<h3>Media policy (MEDPCY)</h3>
<p>Specifies the media policy for the volumes you are creating as a result of saving media information.
</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>*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.
</dd>
<dt><b>*SYSPCY</b></dt>
<dd>The media policy specified in the system policy is assigned to output volumes from this save operation.
</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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.OPTION"></a>
<h3>Option (OPTION)</h3>
<p>Specifies whether you want to save media information at the object or library level.
</p>
<dl>
<dt><b><u>*LIB</u></b></dt>
<dd>You save media information at the library level. Recovery can only be done for libraries, not individual objects in libraries.
</dd>
<dt><b>*OBJ</b></dt>
<dd>You save media information at the object level. Recovery can be done for libraries, individual objects in libraries or members in physical files.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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. 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>
<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 files access paths over them are saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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>
<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 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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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>
<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 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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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>
<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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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>
<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>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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SAVMEDIBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Saving Media Information for a Control Group</b>
</p>
<p>
<pre>
SAVMEDIBRM DEV(*MEDCLS) MEDPCY(FULL) OPTION(*OBJ) CTLGRP(CG01)
</pre>
</p>
<p>This command saves object level information for control group CG01. The recovery information can be written to any device that supports the media class specified in the media policy FULL.
</p>
<p><b>Example 2: Saving Media Information and Access Paths</b>
</p>
<p>
<pre>
SAVMEDIBRM DEV(*MEDCLS) MEDPCY(FULL) OPTION(*OBJ) ACCPTH(*YES)
</pre>
</p>
<p>This command saves all BRMS object level recovery information including access paths to any device that supports the media class specified in the media policy FULL.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SAVMEDIBRM.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="#SAVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>