264 lines
12 KiB
HTML
264 lines
12 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>Start Expiration for BRM (STREXPBRM)</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="STREXPBRM.Top_Of_Page"></a>
|
|
<h2>Start Expiration for BRM (STREXPBRM)</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="#STREXPBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STREXPBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STREXPBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STREXPBRM"></a>
|
|
<p>The Start Media Expiration Processing for BRM (STREXPBRM) command expires media that is in the BRMS media content information database. When media is expired it can be reused in save processing. Volumes are expired when the expiration date or number of days are exceeded or when the volume has been reused. Volumes that are expired are marked with *YES in the <b>Expired </b>field on the Work with Media display. The STREXPBRM command can be scheduled to run periodically or can be processed as part of the STRMNTBRM command. The Media Expiration report can be produced by specifying *REPORT in the <b>Active file action (ACTION)</b> parameter. The report, if printed, is written to the printer file QP1AEP.
|
|
</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="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STREXPBRM.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="#STREXPBRM.ACTFILCNT"><b>ACTFILCNT</b></a></td>
|
|
<td valign="top">Active file count</td>
|
|
<td valign="top">0-999, <b><u>0</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STREXPBRM.ACTION"><b>ACTION</b></a></td>
|
|
<td valign="top">Active file action</td>
|
|
<td valign="top"><b><u>*REPORT</u></b>, *EXPMED</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STREXPBRM.EXPSETMED"><b>EXPSETMED</b></a></td>
|
|
<td valign="top">Expire media set volumes</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STREXPBRM.ACTFILRET"><b>ACTFILRET</b></a></td>
|
|
<td valign="top">File retention type</td>
|
|
<td valign="top"><b><u>*ANY</u></b>, *VERSION</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STREXPBRM.SLTCRTDATE"><b>SLTCRTDATE</b></a></td>
|
|
<td valign="top">Select creation dates</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Beginning creation date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*BEGIN</u></b>, *CURRENT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Ending creation date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*END</u></b>, *CURRENT</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STREXPBRM.ACTFILCNT"></a>
|
|
<h3>Active file count (ACTFILCNT)</h3>
|
|
<p>Specifies the number of active files that are allowed to exist on a volume before an expiration warning is issued for the volume in the Media Expiration report or automatically expired if the *EXPMED choice is selected for the <b>Active file action (ACTION)</b> parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the <b>Active file count (ACTFILCNT)</b> parameter is 0, and you specify *REPORT in the <b>Active file action (ACTION)</b> parameter, BRMS produces a report and expires media with 0 active files. If the <b>Active file count (ACTFILCNT)</b> parameter is greater than 0, only a report is produced.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>0</u></b></dt>
|
|
<dd>The default number of active files is 0.
|
|
</dd>
|
|
<dt><b><i>number-of-files</i></b></dt>
|
|
<dd>Specify the number of active files. You can specify from 0 to 999 active files.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STREXPBRM.ACTION"></a>
|
|
<h3>Active file action (ACTION)</h3>
|
|
<p>Specifies the action that you want to perform, based on the value specified in the <b>Active file count (ACTFILCNT)</b> parameter. You can print the Media Expiration report, expire media or take no action.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPORT</u></b></dt>
|
|
<dd>A warning is issued in the Media Expiration report for all media that have a number of active files equal to or less than the number of active files specified in the <b>Active file count (ACTFILCNT)</b> parameter.
|
|
<p>
|
|
<b>Note: </b>An exception to this is that if the <b>Active file count (ACTFILCNT)</b> parameter is 0, media with no active files will be expired.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*EXPMED</b></dt>
|
|
<dd>Media is expired that has a number of active files equal to or less than the number of active files specified in the <b>Active file count (ACTFILCNT)</b> parameter and the active file count is less than the total number of files on the volume. For example, if you specified 1 in the <b>Active file count (ACTFILCNT)</b> parameter and the media held only one file, the media would not expire. If the media held two files and one file was active and the other had expired, the media would be allowed to expire.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STREXPBRM.EXPSETMED"></a>
|
|
<h3>Expire media set volumes (EXPSETMED)</h3>
|
|
<p>Specifies whether to expire all eligible media in a media set with no active files when the STREXPBRM command processes. This will cause media that are members of media sets to expire even if there is unexpired media with active file sequences at subsequent positions in the set. This allows the media to be reused prior to expiration of the set and reduces the number of active media being managed. By default, BRMS will not expire media in a set prior to unexpirable media unless the entire set can be expired.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Volumes in a media set are not expired unless the entire set is expired.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Volumes in a media set are expired.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>Expiring all eligible media in a set can reduce the size of the set or create two or more new sets.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>It is recommended that you run this function periodically and it can be a long running process.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STREXPBRM.ACTFILRET"></a>
|
|
<h3>File retention type (ACTFILRET)</h3>
|
|
<p>Specifies the type of retention for the active files that you want to include in media expiration.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ANY</u></b></dt>
|
|
<dd>Include active files with any type of retention.
|
|
</dd>
|
|
<dt><b>*VERSION</b></dt>
|
|
<dd>Include only active files whose expiration is based on version retention.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STREXPBRM.SLTCRTDATE"></a>
|
|
<h3>Select creation dates (SLTCRTDATE)</h3>
|
|
<p>Specifies a range of creation dates that you want to use when selecting media to expire or report. The <b>Beginning creation date </b>is the beginning of a date range of media selected and the <b>Ending creation date </b>is the end of the date range of creation dates.
|
|
</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>Note: </b>This parameter is active only when you specify *EXPMED in the <b>Active file action (ACTION)</b> parameter.
|
|
</p>
|
|
<p><b>Element 1: Beginning creation date </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BEGIN</u></b></dt>
|
|
<dd>Uses the earliest media volume creation date that is on the file for the beginning of the creation date range.
|
|
</dd>
|
|
<dt><b><i>beginning-creation-date</i></b></dt>
|
|
<dd>Specify a date that is the beginning of the creation date range. The date must be less than or equal to the current date.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>Uses the current date as the beginning of the creation date range.
|
|
</dd>
|
|
<dt><b><i>number-of-days</i></b></dt>
|
|
<dd>Specify the number of days before the current day that is used to determine the beginning date of the date range.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending creation date </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*END</u></b></dt>
|
|
<dd>The last creation date in the media inventory is used as the end of the creation date range.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>Uses the current date as the ending of the creation date range.
|
|
</dd>
|
|
<dt><b><i>ending-creation-date</i></b></dt>
|
|
<dd>Specify a date that is the ending of the creation date range. The date must be equal to or greater than the beginning creation date and less than or equal to the current date.
|
|
</dd>
|
|
<dt><b><i>number-of-days</i></b></dt>
|
|
<dd>Specify the number of days before the current day that is used to determine the ending date of the date range.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STREXPBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Expiring Volumes Under Version Control</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STREXPBRM ACTFILCNT(2) ACTION(*EXPMED) ACTFILRET(*VERSION)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts expiration processing for any volume that has 2 or less active files on it and whose media expiration is controlled using version control.
|
|
</p>
|
|
<p><b>Example 2: Expiring Volumes in a Set</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STREXPBRM ACTION(*EXPMED) EXPSETMED(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts expiration processing for expiring volumes contained in a set if there are no active files on the volumes.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STREXPBRM.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 &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="#STREXPBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|