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

207 lines
7.8 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 Log Entries from BRM (RMVLOGEBRM)</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="RMVLOGEBRM.Top_Of_Page"></a>
<h2>Remove Log Entries from BRM (RMVLOGEBRM)</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="#RMVLOGEBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVLOGEBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVLOGEBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVLOGEBRM"></a>
<p>The Remove Log Entries from BRM (RMVLOGEBRM) command clears the BRMS log based on a type of entry and a date range that you specify.
</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="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVLOGEBRM.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="#RMVLOGEBRM.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type</td>
<td valign="top"><b><u>*ALL</u></b>, *ARC, *BKU, *MAINT, *MED, *MGR, *RCY, *RTV, *SEC</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RMVLOGEBRM.SLTDATE"><b>SLTDATE</b></a></td>
<td valign="top">Select dates</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: From date</td>
<td valign="top">
<i>Character value</i>, <b><u>*CURRENT</u></b>, *BEGIN</td>
</tr>
<tr>
<td valign="top">Element 2: To date</td>
<td valign="top">
<i>Character value</i>, <b><u>*CURRENT</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVLOGEBRM.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>Specifies the type of entries that you want to clear from the BRMS log. Examples of types of entries are backup, archive and so on.
</p>
<p>
<b>Note: </b>The default for the TYPE parameter depends on the area of BRMS that you use to access this command. For instance, if you access this command from a backup menu, the default Type is *BKU. If you access the command from the archive menu, the default Type is *ARC and so on. If you type the command on a command line or from the System Policy display, the default is *ALL.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Selects all log entries to clear within the specified date range.
</dd>
<dt><b>*ARC</b></dt>
<dd>Selects only archive log entries to clear within the specified date range.
<p>
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
</p>
</dd>
<dt><b>*BKU</b></dt>
<dd>Selects only back up log entries to clear within the specified date range.
</dd>
<dt><b>*MAINT</b></dt>
<dd>Selects only maintenance log entries to clear within the specified date range.
</dd>
<dt><b>*MED</b></dt>
<dd>Selects only media management log entries to clear within the specified date range.
</dd>
<dt><b>*MGR</b></dt>
<dd>Selects only migration log entries to clear within the specified date range.
<p>
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
</p>
</dd>
<dt><b>*RCY</b></dt>
<dd>Selects only recovery log entries to clear within the specified date range.
</dd>
<dt><b>*RTV</b></dt>
<dd>Selects only retrieve log entries to clear within the specified date range.
<p>
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
</p>
</dd>
<dt><b>*SEC</b></dt>
<dd>Selects only security log entries to remove within the specified date range. Only log entries whose primary area are security will be removed. An entry may be logged for any reason and have security as a secondary area.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVLOGEBRM.SLTDATE"></a>
<h3>Select date (SLTDATE)</h3>
<p>Specifies a range of dates that you want to use when selecting entries to remove from the BRMS log. The <b>From date </b> is the beginning point in the date range and the <b>To date </b>is the end of the date range.
</p>
<p>
<b>Note: </b>Using this parameter, it is possible to enter a date with no separator, or a number of days which can be up to 5 digits in length. For instance, if you are using month/day/year format, the number 12904 would be formatted as January 29, 2004. If on the other hand, you entered a number 13904, BRMS assume that this is not a date, but rather is a number. BRMS always tries to calculate a calendar date first when a number is entered and then if the date it calculates is not valid, assumes that it is a number of days. If the number that is entered is over 5 digits and the date that it calculates is not valid, you receive an error message.
</p>
<p><b>Element 1: From date </b>
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The current date is the starting point of the range of dates used to remove entries from the BRMS history log.
</dd>
<dt><b>*BEGIN</b></dt>
<dd>The earliest log entry in the BRMS log is the beginning date of the date range.
</dd>
<dt><b><i>from-date</i></b></dt>
<dd>Specify the date entered in job date format with or without date separators that you want to be the beginning date of the date range.
</dd>
<dt><b><i>number-of-days</i></b></dt>
<dd>Specify the number of days before the current day that is the beginning date of the date range.
</dd>
</dl>
<p><b>Element 2: To date </b>
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The current date is the ending date of the date range.
</dd>
<dt><b>*END</b></dt>
<dd>The last date in the log is the ending date of the date range.
</dd>
<dt><b><i>to-date</i></b></dt>
<dd>Specify the date in job date format with or without date separators that you want to be the ending date of the date range.
</dd>
<dt><b><i>number-of-days</i></b></dt>
<dd>Specify the number of days before the current day that is the ending date of the date range.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVLOGEBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Removing Entries from the BRMS Log Based on a Date Range</b>
</p>
<p>
<pre>
RMVLOGEBRM SLTDATE('1/1/03' '4/01/03')
</pre>
</p>
<p>This command removes all log entries from January 1, 2003 to April 1, 2003 from the log.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVLOGEBRM.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="#RMVLOGEBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>