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

137 lines
5.5 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>Remove Media Info from BRM (RMVMEDIBRM)</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="RMVMEDIBRM.Top_Of_Page"></a>
<h2>Remove Media Info from BRM (RMVMEDIBRM)</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="#RMVMEDIBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVMEDIBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVMEDIBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVMEDIBRM"></a>
<p>The Remove Media Information from BRM (RMVMEDIBRM) command is used to specify when to remove records from the BRMS media content information and how long to keep object detail. The <b>Media contents (MEDCON)</b> parameter indicates whether records are to be removed when they expire or when the expired volume is re-used. The <b>Object level detail (OBJDTL)</b> parameter indicates when the object level detail is to be removed. You can remove object level detail at the same time you remove record level information or you can specify a number of days to keep object information.
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVMEDIBRM.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="#RMVMEDIBRM.MEDCON"><b>MEDCON</b></a></td>
<td valign="top">Media contents</td>
<td valign="top"><b><u>*EXP</u></b>, *REUSE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RMVMEDIBRM.OBJDTL"><b>OBJDTL</b></a></td>
<td valign="top">Object level detail</td>
<td valign="top">1-9999, <b><u>*MEDCON</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVMEDIBRM.MEDCON"></a>
<h3>Media contents (MEDCON)</h3>
<p>Specifies whether records are removed when media expires or when the media is re-used.
</p>
<dl>
<dt><b><u>*EXP</u></b></dt>
<dd>All BRMS media content information entries that have an Expiration date that are equal to or less than the current date are removed from the media content information.
</dd>
<dt><b>*REUSE</b></dt>
<dd>Media content information entries associated with a media volume are not removed from the file until the volume is re-used, even though the volume has already expired.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVMEDIBRM.OBJDTL"></a>
<h3>Object detail (OBJDTL)</h3>
<p>Specifies when you want to remove object level detail for media records in the media content information.
</p>
<dl>
<dt><b><u>*MEDCON</u></b></dt>
<dd>The object level detail information is removed based on the value specified in the <b>Media contents (MEDCON)</b> parameter.
</dd>
<dt><b><i>number-of-days</i></b></dt>
<dd>Specify the number of days that object detail for an entry is kept on the file. If this number of days is greater than the number of days implied in the <b>Media contents (MEDCON)</b> parameter, such as the volume expires in 60 days and you specify 90 days in the <b>Object level detail (OBJDTL)</b> parameter, the parameter has no meaning since the contents record has already been removed. However, if you specify 45 days and the object expires in 60 days, the object level detail is removed after 45 days and the accompanying contents record is removed after 60 days.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVMEDIBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Removing Media Information from BRMS</b>
</p>
<p>
<pre>
RMVMEDIBRM MEDCON(*REUSE) OBJDTL(45)
</pre>
</p>
<p>This command allows you to remove BRMS media contents information. In the example, media contents information remains on the BRMS media contents file until the media is reused and accompanying object detail is removed after 45 days.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVMEDIBRM.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>BRM4040</b></dt>
<dd>Access denied for user &amp;1.
</dd>
<dt><b>BRM40A2</b></dt>
<dd>BRMS product initialization required.
</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="#RMVMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>