766 lines
30 KiB
HTML
766 lines
30 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 Maintenance for BRM (STRMNTBRM)</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="STRMNTBRM.Top_Of_Page"></a>
|
|
<h2>Start Maintenance for BRM (STRMNTBRM)</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="#STRMNTBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRMNTBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRMNTBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRMNTBRM"></a>
|
|
<p>The Start Maintenance for BRM (STRMNTBRM) command performs various BRMS maintenance and clean-up functions. The STRMNTBRM command can be scheduled to process periodically either by manual submission or inclusion in an automatic job scheduler.
|
|
</p>
|
|
<p>The STRMNTBRM command processes several other commands that can be run separately. These include:
|
|
</p>
|
|
<ul>
|
|
<li>RMVMEDIBRM - Remove media information from BRM
|
|
</li>
|
|
<li>MOVMEDBRM - Move media using BRM
|
|
</li>
|
|
<li>STREXPBRM - Expire media from BRM
|
|
</li>
|
|
<li>RMVLOGEBRM - Remove BRM log entries
|
|
</li>
|
|
<li>WRKMEDIBRM - Work with media information
|
|
</li>
|
|
<li>STRRCYBRM - Recovery analysis
|
|
</li>
|
|
</ul>
|
|
<p>The STRMNTBRM produces multiple reports depending on the print options you select as well as the current conditions that it detects. For instance, the Centralized Media Audit report will not print if you are not using a clustered network environment in BRMS. Listed below are the printer files and associated reports that can be produced when the STRMNTBRM command processes:
|
|
</p>
|
|
<ul>
|
|
<li>QP1AVER - Version Control
|
|
</li>
|
|
<li>QP1AEP - Media Expiration
|
|
</li>
|
|
<li>QP1AMM - Media Report by Expiration Date
|
|
</li>
|
|
<li>QP1AHS - Media Information
|
|
</li>
|
|
<li>QP1ALE - Save Strategy Exceptions
|
|
</li>
|
|
<li>QP1ARCY - Recovering Your Entire System
|
|
</li>
|
|
<li>QP1AASP - Display ASP Information
|
|
</li>
|
|
<li>QP1ARW - Recovery Activities
|
|
</li>
|
|
<li>QP1A2SL - Location Analysis
|
|
</li>
|
|
<li>QP1ASYN - Centralized Media Audit
|
|
</li>
|
|
<li>QP1A2RCY - Recovery Volume Summary
|
|
</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>This command should not be used by control group *EXIT item processing as results will be unpredictable.
|
|
</li>
|
|
<li>All object authority is required to run this command.
|
|
</li>
|
|
<li>This command should not be run as a remote command.
|
|
</li>
|
|
<li>Depending on the size of your media inventory, this command can take a long time to process.
|
|
</li>
|
|
<li>This command should be run as an independent job. No other BRMS functions should be active when the STRMNTBRM command is processing.
|
|
</li>
|
|
<li>Reorganizing the BRMS database files can be a long running process requiring additional disk storage. Reorganization will occur on all BRMS data base files. Reorganization of files may be skipped if sufficient disk storage is not available, or if the file has no members or records.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRMNTBRM.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="#STRMNTBRM.EXPMED"><b>EXPMED</b></a></td>
|
|
<td valign="top">Expire media</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.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" rowspan="3"><a href="#STRMNTBRM.RMVMEDI"><b>RMVMEDI</b></a></td>
|
|
<td valign="top">Remove media information</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Media contents</td>
|
|
<td valign="top">
|
|
<b><u>*EXP</u></b>, *NONE, *REUSE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Object level detail</td>
|
|
<td valign="top">
|
|
1-9999, <b><u>*MEDCON</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.RMVMGRINF"><b>RMVMGRINF</b></a></td>
|
|
<td valign="top">Remove migration information</td>
|
|
<td valign="top">1-9999, <b><u>180</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.MOVMED"><b>MOVMED</b></a></td>
|
|
<td valign="top">Run media movement</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#STRMNTBRM.RMVLOGE"><b>RMVLOGE</b></a></td>
|
|
<td valign="top">Remove log entries</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Type</td>
|
|
<td valign="top">
|
|
<b><u>*ALL</u></b>, *NONE, *ARC, *BKU, *MAINT, *MED, *MGR, *RCY, *RTV, *SEC</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: From date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*BEGIN</u></b>, *CURRENT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: To date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>90</u></b>, *CURRENT, *END</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.RUNCLNUP"><b>RUNCLNUP</b></a></td>
|
|
<td valign="top">Run cleanup operations</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.RTVVOLSTAT"><b>RTVVOLSTAT</b></a></td>
|
|
<td valign="top">Retrieve volume statistics</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.AUDSYSMED"><b>AUDSYSMED</b></a></td>
|
|
<td valign="top">Audit system media</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *NETGRP<br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.CHGJRN"><b>CHGJRN</b></a></td>
|
|
<td valign="top">Change BRM journal receivers</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.PRTEXPMED"><b>PRTEXPMED</b></a></td>
|
|
<td valign="top">Print expired media report</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.PRTVSNRPT"><b>PRTVSNRPT</b></a></td>
|
|
<td valign="top">Print version report</td>
|
|
<td valign="top"><b><u>*EXPMED</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.PRTBKUACT"><b>PRTBKUACT</b></a></td>
|
|
<td valign="top">Print media information</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.PRTRCYRPT"><b>PRTRCYRPT</b></a></td>
|
|
<td valign="top">Print recovery reports</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b>, *NONE<br>Other values (up to 3 repetitions): *RCYACT, *RCYANL, *SAVEXCP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.RCYLOC"><b>RCYLOC</b></a></td>
|
|
<td valign="top">Recovery locations</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 10 repetitions): <i>Name</i>, *HOME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.PRTSYSINF"><b>PRTSYSINF</b></a></td>
|
|
<td valign="top">Print system information</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMNTBRM.RGZBRMDB"><b>RGZBRMDB</b></a></td>
|
|
<td valign="top">Reorganize BRMS database</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#STRMNTBRM.REFREE"><b>REFREE</b></a></td>
|
|
<td valign="top">Auto-retrieved objects</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Refree</td>
|
|
<td valign="top">
|
|
<b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRMNTBRM.EXPMED"></a>
|
|
<h3>Expire media (EXPMED)</h3>
|
|
<p>Specifies whether to expire media when the STRMNTBRM command processes. Expired save files that have been copied to tape are deleted when this command is run. The STREXPBRM command is processed by the STRMNTBRM command to expire media.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Media is expired when maintenence is run.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Media is not expired when maintenence is run.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.EXPSETMED"></a>
|
|
<h3>Expire media set volumes (EXPSETMED)</h3>
|
|
<p>Specifies whether to expire media set volumes when the STRMNTBRM 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 when the STRMNTBRM command is processed unless the entire set is expired.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Volumes in a media set are expired when the STRMNTBRM command is processed.
|
|
</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="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RMVMEDI"></a>
|
|
<h3>Remove media information (RMVMEDI)</h3>
|
|
<p>Specifies what information to remove from the BRMS media content inventory and how long to keep object detail. The RMVMEDIBRM command is used by the STRMNTBRM command to accomplish BRMS media content information removal. The <b>Media contents (MEDCON)</b> parameter indicates when media content information is removed from the media content information and the <b>Object level detail (OBJDTL)</b> parameter indicates when the object level detail is to be removed.
|
|
</p>
|
|
<p><b>Element 1: Media contents </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EXP</u></b></dt>
|
|
<dd>All BRMS media media content information entries that have an expiration date that is equal to or less than the current date are removed from the media content inventory.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No media content information is to be removed from the media content information inventory when the STRMNTBRM command is run.
|
|
</dd>
|
|
<dt><b>*REUSE</b></dt>
|
|
<dd>Media content information associated with a volume is not removed from the media content inventory file until the volume is re-used, even though the volume has already expired.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Object level detail </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MEDCON</u></b></dt>
|
|
<dd>Object detail is removed when media content information is removed.
|
|
</dd>
|
|
<dt><b><i>number-of-days</i></b></dt>
|
|
<dd>Specify the number of days that object detail is kept in the media content inventory. If this number of days is greater than the number of days implied in the <b>Media contents </b>field, such as the volume expires in 60 days and you specify 90 days for the <b>Object level detail </b>, the value has no effect since object detail is always removed when media content information is removed. However, if you specify 45 days and the object expires in 60 days, the object level detail is removed 15 days before other media content information is removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RMVMGRINF"></a>
|
|
<h3>Remove migration information (RMVMGRINF)</h3>
|
|
<p>Specifies how old in number of days that migration information should be before it is removed from the migration information history.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>180</u></b></dt>
|
|
<dd>Migration information is removed from the migration information history after 180 days.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Migration information is not removed from the migration information history.
|
|
</dd>
|
|
<dt><b><i>number-of-days</i></b></dt>
|
|
<dd>Specify the number of days after which migration information is considered old and no longer useful. For instance, if you specified 200, migration information older than 200 days would be removed from the migration information history when the STRMNTBRM command was processed. You can specify from 1 to 9999 days.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.MOVMED"></a>
|
|
<h3>Run media movement (MOVMED)</h3>
|
|
<p>Specifies whether to process scheduled media movement. The MOVMEDBRM command is processed by the STRMNTBRM command to move the selected media.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Media movements are not processed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Scheduled media movements are processed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RMVLOGE"></a>
|
|
<h3>Remove log entries (RMVLOGE)</h3>
|
|
<p>Specifies whether to remove log entries when the STRMNTBRM command is run. You can specify the type of log entries that you want to remove and a date range of log entries. The RMVLOGEBRM command is processed by the STRMNTBRM command to remove log entries.
|
|
</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: Type </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Selects all log entries to remove within the specified date range.
|
|
</dd>
|
|
<dt><b>*ARC</b></dt>
|
|
<dd>Selects only archive log entries to remove 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 remove within the specified date range.
|
|
</dd>
|
|
<dt><b>*MAINT</b></dt>
|
|
<dd>Selects only maintenance log entries to remove within the specified date range.
|
|
</dd>
|
|
<dt><b>*MED</b></dt>
|
|
<dd>Selects only media management log entries to remove within the specified date range.
|
|
</dd>
|
|
<dt><b>*MGR</b></dt>
|
|
<dd>Selects only migration log entries to remove 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>*NONE</b></dt>
|
|
<dd>No log entries are removed when the STRMNTBRM command processes.
|
|
</dd>
|
|
<dt><b>*RCY</b></dt>
|
|
<dd>Selects only recovery log entries to remove within the specified date range.
|
|
</dd>
|
|
<dt><b>*RTV</b></dt>
|
|
<dd>Selects only retrieve log entries to remove 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>
|
|
<p><b>Element 2: From date </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BEGIN</u></b></dt>
|
|
<dd>The earliest log entry date in the BRMS log is the beginning date of the date range.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The current date is the starting point of the range of dates used to remove entries from the BRMS log.
|
|
</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 used to determine the beginning date of the date range.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: To date </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>90</u></b></dt>
|
|
<dd>90 days before the current day is the ending date of the date range.
|
|
</dd>
|
|
<dt><b>*CURRENT</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 used to determine the ending date of the date range.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RUNCLNUP"></a>
|
|
<h3>Run cleanup operations (RUNCLNUP)</h3>
|
|
<p>Specifies whether BRMS is to run clean up operations when the STRMNTBRM command processes. Cleanup operations includes various BRMS general routines such as creation of the location analysis report, analysis of deleted libraries, media policies with expiration dates that have past, and more.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Clean up operations are performed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Clean up operations are not performed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RTVVOLSTAT"></a>
|
|
<h3>Retrieve volume statistics (RTVVOLSTAT)</h3>
|
|
<p>Specifies whether BRMS is to retrieve volume statistics when the STRMNTBRM command processes.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Volume statistics are retrieved when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Volume statistics are not retrieved when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.AUDSYSMED"></a>
|
|
<h3>Audit system media (AUDSYSMED)</h3>
|
|
<p>Specifies whether media information as contained by one or more systems in the network group should be audited and differences in media information resolved. You can enter one or more system/network identifiers or you can select the special value *NETGRP for all systems in the network group or *NONE for none of the systems in the network group.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Running shared inventory audit processing on each and every system using STRMNTBRM results in undue system and communications work. This auditing could be performed on just one system, in order to accomplish the same result.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Shared inventory audit processing is not generally required (except when users are restoring a back level QUSRBRM database) and need a way to resynchronize this local back level copy, or correct for problems due to loss of QA1ANET2 records.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Shared inventory audit processing is skipped if the current system is in restricted state or the remote systems required to complete the audit are not available.
|
|
</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>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No media information for any system in the network group is to be audited and differences resolved.
|
|
</dd>
|
|
<dt><b>*NETGRP</b></dt>
|
|
<dd>Media information for all systems in the network group is to be audited and differences resolved.
|
|
<p>
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 50 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>location-name</i></b></dt>
|
|
<dd>Specify the name of the remote location associated with the system. The local system's network identifier, as seen by using the DSPNETA command, is used as the system's network identifier.
|
|
<p>
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to specify a remote system.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>network-id.location-name</i></b></dt>
|
|
<dd>Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
|
|
<p>
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to specify a remote system.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.CHGJRN"></a>
|
|
<h3>Change BRM journal receivers (CHGJRN)</h3>
|
|
<p>Specifies whether to change the receivers for the BRMS journals when the STRMNTBRM command processes. When the BRMS journal receivers are changed, the old BRMS journal receiver is deleted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The journal receivers are changed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The journal receivers are not changed when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.PRTEXPMED"></a>
|
|
<h3>Print expired media report (PRTEXPMED)</h3>
|
|
<p>Specifies whether to print a report of media that was expired when the STRMNTBRM command processes.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>A report of media that was expired prints when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No report is created of the media that was expired when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.PRTVSNRPT"></a>
|
|
<h3>Print version report (PRTVSNRPT)</h3>
|
|
<p>Specifies whether to print a version control report when the STRMNTBRM command processes. The special value *EXPMED indicates that the version control report should be printed whenever media expiration processing is performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EXPMED</u></b></dt>
|
|
<dd>Print a version control report whenever media expiration processing is performed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No version control report prints when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>A version control report prints when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.PRTBKUACT"></a>
|
|
<h3>Print media information (PRTBKUACT)</h3>
|
|
<p>Specifies whether to print a report of what was backed up. The report will include backups done the day of the report and the previous day. The Work with Media Information using BRM (WRKMEDIBRM) command with parameter OUTPUT(*PRINT) is run by the STRMNTBRM command to produce the report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>A report is printed of what was backed up today and yesterday when the STRMNTBRM command is run.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No report is created of what was backed up.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.PRTRCYRPT"></a>
|
|
<h3>Print recovery reports (PRTRCYRPT)</h3>
|
|
<p>Specifies which recovery reports to print for recovery when the STRMNTBRM command runs. If you want to print two of the three reports, specify the special values for the reports. If you want to print all three of the reports, specify *ALL.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Print all reports for recovery when the STRMNTBRM command is processed. Recovery information that is printed will included system information. Reports generated from the value *SYSINF will not be included with *ALL.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>You do not want to print any of the reports when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*RCYACT</b></dt>
|
|
<dd>Print the Recovery Activities report when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*RCYANL</b></dt>
|
|
<dd>Print the Recovery Analysis report when the STRMNTBRM command is processed.
|
|
</dd>
|
|
<dt><b>*SAVEXCP</b></dt>
|
|
<dd>Print the Save Strategy Exceptions report when the STRMNTBRM command is processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RCYLOC"></a>
|
|
<h3>Recovery locations (RCYLOC)</h3>
|
|
<p>Specifies the locations for which you want to print recovery reports. Reports printed depend on the value specified in the <b>Print recovery reports (PRTRCYRPT)</b> parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Reports are printed for all locations.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 10 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>location-name</i></b></dt>
|
|
<dd>Specify the location names for which you want to print reports.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.PRTSYSINF"></a>
|
|
<h3>Print system information (PRTSYSINF)</h3>
|
|
<p>Indicates if BRMS should issue the i5/OS command PRTSYSINF to produce reports of system information. These reports include user library information, system hardware and resource information, configuration information, and much more.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>BRMS will not issue the PRTSYSINF command and the associated reports will not be generated.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>BRMS will issue the PRTSYSINF command and the associated reports will be generated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.RGZBRMDB"></a>
|
|
<h3>Reorganize BRMS data base (RGZBRMDB)</h3>
|
|
<p>Use this parameter to reorganize the BRMS database. This option removes deleted records from the BRMS database. You should reorganize the BRMS database on a periodic basis, particularly if you save many objects and save with object detail.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Reorganizing the BRMS database can be a long running process requiring additional disk storage. Reorganization will occur on the BRMS media inventory, media information (history) and object detail. BRMS may skip reorganization of the database if sufficient disk storage is not available, or if the database has no members or records.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The BRMS database is not reorganized.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The BRMS database is reorganized.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMNTBRM.REFREE"></a>
|
|
<h3>Refree auto-retrieved objects (REFREE)</h3>
|
|
<p>Use this parameter to refree archive objects that have been auto-retrieved.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not refree auto-retrieved objects.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Refree auto-retrieved objects.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRMNTBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Start Maintenance, Move Media, Clean the Archive Log</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRMNTBRM MOVMED(*YES) RMVLOGE(*ARC)
|
|
</pre>
|
|
</p>
|
|
<p>This command performs normal maintenance, starts media movement processing, and removes archive entries that are older than 90 days old from the BRMS log.
|
|
</p>
|
|
<p><b>Example 2: Start Maintenance to Reorganize the BRMS Database Files</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRMNTBRM RGZBRMDB(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command performs normal maintenance and runs the RGZDBF commmands on all the BRMS data base files.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRMNTBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>BRM1177</b></dt>
|
|
<dd>Cannot establish connection with remote system.
|
|
</dd>
|
|
<dt><b>BRM1343</b></dt>
|
|
<dd>Date &2 is not correct.
|
|
</dd>
|
|
<dt><b>BRM1856</b></dt>
|
|
<dd>Job information cannot be retrieved. Errors occurred.
|
|
</dd>
|
|
<dt><b>BRM1868</b></dt>
|
|
<dd>File &1 not opened successfully.
|
|
</dd>
|
|
<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>BRM4041</b></dt>
|
|
<dd>Access denied for user &1.
|
|
</dd>
|
|
<dt><b>BRM40A2</b></dt>
|
|
<dd>BRMS product initialization required.
|
|
</dd>
|
|
<dt><b>BRM6708</b></dt>
|
|
<dd>Command ended due to error.
|
|
</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="#STRMNTBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|