friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/wrkmgribrm.htm

428 lines
16 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Work with Migration Info (WRKMGRIBRM)</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="WRKMGRIBRM.Top_Of_Page"></a>
<h2>Work with Migration Info (WRKMGRIBRM)</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="#WRKMGRIBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKMGRIBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKMGRIBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKMGRIBRM"></a>
<p>The Work with Migration Information using BRM (WRKMGRIBRM) command displays or reports migration information based on specified items, item type, date range, migration status, migration policy, source auxiliary storage pool and/or target auxiliary storage pool. Default values are provided to produce the most inclusive display or report. A <b>Sequence (SORT)</b> parameter allows the user to specify the sequence of the resulting output. The <b>Entries to be displayed first (START)</b> parameter determines whether the resulting output is positioned at the beginning or end of the information. The report, if printed, is written to printer file QP1AHH.
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
<p><b>Restriction: </b>
</p>
<ul>
<li>The BRMS Advanced feature (Option 2) is required to use this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKMGRIBRM.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="#WRKMGRIBRM.TYPE"><b>TYPE</b></a></td>
<td valign="top">Item type</td>
<td valign="top">*FLR, <b><u>*LIB</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.FROMASP"><b>FROMASP</b></a></td>
<td valign="top">From ASP</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.TOASP"><b>TOASP</b></a></td>
<td valign="top">To ASP</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.FROMASPCLS"><b>FROMASPCLS</b></a></td>
<td valign="top">From ASP class</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.TOASPCLS"><b>TOASPCLS</b></a></td>
<td valign="top">To ASP class</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#WRKMGRIBRM.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>*BEGIN</u></b>, *CURRENT</td>
</tr>
<tr>
<td valign="top">Element 2: To date</td>
<td valign="top">
<i>Character value</i>, <b><u>*END</u></b>, *CURRENT</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.MGRSTS"><b>MGRSTS</b></a></td>
<td valign="top">Migration status</td>
<td valign="top"><b><u>*ALL</u></b>, *ERROR, *NOERROR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.SORT"><b>SORT</b></a></td>
<td valign="top">Sequence</td>
<td valign="top"><b><u>*DATE</u></b>, *FROMASP, *NAME, *TOASP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.START"><b>START</b></a></td>
<td valign="top">Entries to be displayed first</td>
<td valign="top"><b><u>*LAST</u></b>, *FIRST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMGRIBRM.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKMGRIBRM.TYPE"></a>
<h3>Item type (TYPE)</h3>
<p>Specifies the type of item whose migration information you want to display or report.
</p>
<dl>
<dt><b><u>*LIB</u></b></dt>
<dd>Migration information for libraries is to be included.
</dd>
<dt><b>*FLR</b></dt>
<dd>Migration information for first level folders is to be included.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.LIB"></a>
<h3>Library (LIB)</h3>
<p>Specifies whether all libraries, a generic group of libraries or a single library is to be included in the resulting display or report. This parameter is required when *LIB is specified in the <b>Item type (TYPE)</b> parameter.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>You want to include all libraries in the migration information display or report.
</dd>
<dt><b><i>generic*-library-name</i></b></dt>
<dd>Specify a generic name of a library that you want to include. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete library name.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library about which you want to display or report migration information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.FLR"></a>
<h3>Folder (FLR)</h3>
<p>Specifies whether all libraries, a generic group of libraries or a single folder is to be included in the resulting display or report. This parameter is required when *FLR is specified in the <b>Item type (TYPE)</b> parameter.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>You want to include all libraries in the migration information display or report.
</dd>
<dt><b><i>generic*-folder-name</i></b></dt>
<dd>Specify a generic name of a folder that you want to include. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete folder name.
</dd>
<dt><b><i>folder-name</i></b></dt>
<dd>Specify the name of the folder about which you want to display or report migration information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.FROMASP"></a>
<h3>From ASP (FROMASP)</h3>
<p>Specifies all auxiliary storage pools or a single auxiliary storage pool from which items have been migrated that you want to include in the display or report.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all auxiliary storage pools from which items have been migrated in the display or report.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>Include only items that have been migrated from the system (1) auxiliary storage pool.
</dd>
<dt><b><i>from-ASP-name</i></b></dt>
<dd>Specify the name of the auxiliary storage pool that you want to include in the display or report.
</dd>
<dt><b><i>from-ASP-number</i></b></dt>
<dd>Specify the number of the auxiliary storage pool that you want to include in the display or report.
<p>
<b>Note: </b>UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.TOASP"></a>
<h3>To ASP (TOASP)</h3>
<p>Specifies all auxiliary storage pools or a single auxiliary storage pool to which items have been migrated that you want to include in the display or report.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all auxiliary storage pools to which items have been migrated in the display or report.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>Include only items that have been migrated to the system (1) auxiliary storage pool.
</dd>
<dt><b><i>to-ASP-name</i></b></dt>
<dd>Specify the auxiliary storage pool name that you want to include in the display or report.
</dd>
<dt><b><i>to-ASP-number</i></b></dt>
<dd>Specify the auxiliary storage pool number that you want to include in the display or report.
<p>
<b>Note: </b>UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.FROMASPCLS"></a>
<h3>From class (FROMASPCLS)</h3>
<p>Specifies that auxiliary storage pools in all ASP classes or a single ASP class from which data has been migrated are to be included in the display or report.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All ASP classes are included in the display or report.
</dd>
<dt><b><i>from-ASP-class-name</i></b></dt>
<dd>Specify the ASP class that is to be included in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.TOASPCLS"></a>
<h3>To ASP class (TOASPCLS)</h3>
<p>Specifies that auxiliary storage pools in all ASP classes or a single ASP class to which data has been migrated are to be included in the display or report.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All ASP classes are included in the display or report.
</dd>
<dt><b><i>to-ASP-class-name</i></b></dt>
<dd>Specify the ASP class that is to be included in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.SLTDATE"></a>
<h3>Select dates (SLTDATE)</h3>
<p>Specifies a range of dates that you want to use when reporting on migration information. The <b>From date </b> is the beginning of a date range of migration information 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>*BEGIN</u></b></dt>
<dd>The earliest migration information date on the file is the beginning date of a date range.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date is the beginning date of a date range.
</dd>
<dt><b><i>from-date</i></b></dt>
<dd>Specify the date in job date format with or without date separators that you want to be the beginning date of a 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 starting date of the date range.
</dd>
</dl>
<p><b>Element 2: To date </b>
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>The last date found in the file is the end of the date range for the search.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date 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 a 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="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.MGRSTS"></a>
<h3>Migration status (MGRSTS)</h3>
<p>Specifies whether you want to display or report all successful migration information, unsuccessful migration information or both.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>You want to include both successful and unsuccessful migration information in the display or report.
</dd>
<dt><b>*ERROR</b></dt>
<dd>You want to include only unsuccessful migration information in the display or report.
</dd>
<dt><b>*NOERROR</b></dt>
<dd>You want to include only successful migration information in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.SORT"></a>
<h3>Sequence option (SORT)</h3>
<p>Specifies the way in which migration information is to be sequenced.
</p>
<dl>
<dt><b><u>*DATE</u></b></dt>
<dd>Sequences the migration information by date and time.
</dd>
<dt><b>*FROMASP</b></dt>
<dd>Sequences the migration information by source auxiliary storage pool, target auxiliary storage pool, date and time sequence.
</dd>
<dt><b>*NAME</b></dt>
<dd>Sequences the migration information by item name and type.
</dd>
<dt><b>*TOASP</b></dt>
<dd>Sequences the migration information by target auxiliary storage pool, source auxiliary storage pool, date and time sequence.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.START"></a>
<h3>Entries to be displayed first (START)</h3>
<p>Specifies the starting position of the migration information entries. The display station user can roll the display up or down to see other migration information entries if the migration information entry is on another display screen.
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>Migration information is shown starting with the last entry at the bottom of the display.
</dd>
<dt><b>*FIRST</b></dt>
<dd>Migration information is shown starting with the first entry at the top of the display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMGRIBRM.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
</dd>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMGRIBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
WRKMGRIBRM ITEM(ABC*) TOASP(03)
</pre>
</p>
<p>This command displays the Work with Migration Information panel, where all libraries that begin with the letters 'ABC', and were migrated from any auxiliary storage pool (ASP) to ASP number 3, are displayed in date sequence.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMGRIBRM.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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMGRIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink