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

244 lines
8.7 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>Work with Media Library Media (WRKMLMBRM)</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="WRKMLMBRM.Top_Of_Page"></a>
<h2>Work with Media Library Media (WRKMLMBRM)</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="#WRKMLMBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKMLMBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKMLMBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKMLMBRM"></a>
<p>The Work with Media Library Media using BRM (WRKMLMBRM) command works with all media or specific media in a media library device that you specify. Various parameters can be used to tailor this display or report. The report that is produced is the Media Library Media report. The report, if printed, is written to the printer file QP1A1MD.
</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="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKMLMBRM.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="#WRKMLMBRM.MLB"><b>MLB</b></a></td>
<td valign="top">Media library</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMLMBRM.VOL"><b>VOL</b></a></td>
<td valign="top">Volume</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMLMBRM.CGY"><b>CGY</b></a></td>
<td valign="top">Category</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *EJECT, *INSERT, *IPL, *NL, *NOSHARE, *SHARE400</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMLMBRM.BRMVOL"><b>BRMVOL</b></a></td>
<td valign="top">BRM volume</td>
<td valign="top"><b><u>*ANY</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMLMBRM.MEDCLS"><b>MEDCLS</b></a></td>
<td valign="top">Media 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="#WRKMLMBRM.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="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKMLMBRM.MLB"></a>
<h3>Media library (MLB)</h3>
<p>Use this parameter to specify the media library (MLB) that you want to display or print.
</p>
<p>This is a required field.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMLMBRM.VOL"></a>
<h3>Volume (VOL)</h3>
<p>Specifies all media, a generic media volume or the specific media volume that you want to display or print.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all media for the selected media library in the display or report.
</dd>
<dt><b><i>generic*-media-volume</i></b></dt>
<dd>Specify the generic name of a volume. A generic name is a character string of one or more characters followed by an asterisk (*); for example ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all volumes with names that begin with the generic prefix, for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete volume name.
</dd>
<dt><b><i>media-volume</i></b></dt>
<dd>Specify the media volume for the selected media library device that you want to include in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMLMBRM.CGY"></a>
<h3>Category (CGY)</h3>
<p>Specifies which media by category from the selected media library (MLB) to include in the display or print.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All media in the MLB is to be included in the display or report.
<p>
<b>Note: </b>If you have defined your own media categories, they will not be included when you specify CGY(*ALL).
</p>
</dd>
<dt><b>*CNV</b></dt>
<dd>Only convenience station media in the selected MLB is included in the display or report.
</dd>
<dt><b>*EJECT</b></dt>
<dd>Only media in the eject mode in the selected MLB is included in the display or report.
</dd>
<dt><b>*INSERT</b></dt>
<dd>Only media already in the MLB which does not have a category such as *SHARE400 or *NOSHARE and which are otherwise not assigned to a system is to be included in the display or report.
</dd>
<dt><b>*IPL</b></dt>
<dd>Only alternate IPL media in the selected MLB is included in the display or report.
</dd>
<dt><b>*NL</b></dt>
<dd>Only non-labeled media in the selected MLB is included in the display or report.
</dd>
<dt><b>*NOSHARE</b></dt>
<dd>Only private media already added to the MLB are to be included in the display or report. Private media are those which are only able to be used by this system.
</dd>
<dt><b>*SHARE400</b></dt>
<dd>Only share media already added to the MLB are to be included in the display or report.
</dd>
<dt><b><i>category-name</i></b></dt>
<dd>Specify the user defined media category name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMLMBRM.BRMVOL"></a>
<h3>BRM volume (BRMVOL)</h3>
<p>Specifies whether you want to include only BRMS media, non-BRMS media or any media in the display or report.
</p>
<dl>
<dt><b><u>*ANY</u></b></dt>
<dd>Any media, whether registered in BRMS or not, is included in the display or report.
</dd>
<dt><b>*NO</b></dt>
<dd>Only non-BRMS media is included in the display or report.
</dd>
<dt><b>*YES</b></dt>
<dd>Only media registered in BRMS is included in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMLMBRM.MEDCLS"></a>
<h3>Media class (MEDCLS)</h3>
<p>Specifies the media class that you want to select for the specified media library. You can select a specific media class or all media classes.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Select all media regardless of the media class.
</dd>
<dt><b><i>media-class-name</i></b></dt>
<dd>Specify the name of the media class that you want to use with the specified media library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMLMBRM.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="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMLMBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
WRKMLMBRM MLB(MLB01) BRMVOL(*YES)
</pre>
</p>
<p>This command displays the Work with Media Library Media panel, where BRMS media that is used by MLB01 is shown.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMLMBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1232</b></dt>
<dd>Media class &amp;1 not found.
</dd>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</dd>
<dt><b>BRM40A2</b></dt>
<dd>BRMS product initialization required.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMLMBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>