426 lines
16 KiB
HTML
426 lines
16 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>Add Media Library Media to BRM (ADDMLMBRM)</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="ADDMLMBRM.Top_Of_Page"></a>
|
|
<h2>Add Media Library Media to BRM (ADDMLMBRM)</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="#ADDMLMBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDMLMBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDMLMBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDMLMBRM"></a>
|
|
<p>The Add Media Library Media to BRM (ADDMLMBRM) command allows you to add volumes to a media library (MLB). The command adds the specified media volumes to a usable category and optionally enrolls them to BRMS. If the <b>Add volume to BRM (ADDVOL)</b> parameter is *YES, you can specify a media class for the volume or volumes that you are adding. If the <b>Add volume to BRM (ADDVOL)</b> parameter and the <b>Initialize tape (INZ)</b> parameter are both *YES, you are supplied with additional parameters such as move policy and initialization information.
|
|
</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="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDMLMBRM.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="#ADDMLMBRM.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="#ADDMLMBRM.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top">Single values: <b><u>*INSERT</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.ADDVOL"><b>ADDVOL</b></a></td>
|
|
<td valign="top">Add volume to BRM</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.INZ"><b>INZ</b></a></td>
|
|
<td valign="top">Initialize tape</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.MEDCLS"><b>MEDCLS</b></a></td>
|
|
<td valign="top">Media class</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.MOVDATE"><b>MOVDATE</b></a></td>
|
|
<td valign="top">Last moved date</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.MOVPCY"><b>MOVPCY</b></a></td>
|
|
<td valign="top">Move policy</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.EXPDATE"><b>EXPDATE</b></a></td>
|
|
<td valign="top">Expiration date</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *PERM</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*MLB</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.NEWOWNID"><b>NEWOWNID</b></a></td>
|
|
<td valign="top">New owner identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.CHECK"><b>CHECK</b></a></td>
|
|
<td valign="top">Check for active files</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *FIRST, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.CODE"><b>CODE</b></a></td>
|
|
<td valign="top">Code</td>
|
|
<td valign="top"><b><u>*EBCDIC</u></b>, *ASCII</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDMLMBRM.CLEAR"><b>CLEAR</b></a></td>
|
|
<td valign="top">Clear</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDMLMBRM.MLB"></a>
|
|
<h3>Media library (MLB)</h3>
|
|
<p>Specifies the name of the media library to which you are adding media. The MLB must be one that BRMS lists on its Work with Media Libraries display.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifier of the media being added to the BRMS media inventory.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INSERT</u></b></dt>
|
|
<dd>Volume identifiers that are in the insert category in the MLB are to be changed to a usable category within the MLB based on the value specified in the <b>Add volume to BRM (ADDVOL)</b> parameter. If the value specified in the <b>Add volume to BRM (ADDVOL)</b> parameter is *NO, only volumes already enrolled in BRMS will be changed from the insert category to a usable category. If the value specified in the <b>Add volume to BRM (ADDVOL)</b> parameter is *YES, volumes that are currently enrolled in BRMS as well as those that are not currently enrolled in BRMS and are in the insert category, will be added to BRMS and changed from the insert category to a usable category.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the identifier of the volume or volumes that you want to change from the insert category to a usable category within the MLB.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.ADDVOL"></a>
|
|
<h3>Add volume to BRM (ADDVOL)</h3>
|
|
<p>Specifies whether you want to add the volumes specified in the <b>Volume identifier (VOL)</b> parameter to the BRMS media inventory.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>You want to add the volumes specified to the BRMS media inventory. When you specify *YES, you are asked to supply a media class in the <b>Media class (MEDCLS)</b> parameter.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>You do not want to add the volumes specified to the BRMS media inventory.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.INZ"></a>
|
|
<h3>Initialize tape (INZ)</h3>
|
|
<p>Specifies whether you want to initialize the volumes specified in the <b>Volume identifier (VOL)</b> parameter. This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>You do not want to format the specified volumes.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>You want to format the specified volumes. When you specify *YES, you are asked to supply a device and initialization information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.MEDCLS"></a>
|
|
<h3>Media class (MEDCLS)</h3>
|
|
<p>Specifies the name of a media class for the volume you are adding. Media classes can be reviewed in the Work with Media Classes display.
|
|
</p>
|
|
<p>The media class is also used to determine the category for volumes that are being added to the media library. If the <b>Shared media </b>attribute in the media class is *NO, the category is changed from *INSERT to *NOSHARE, otherwise the category is changed to *SHARE400.
|
|
</p>
|
|
<p>This is a required parameter if ADDVOL=*YES. This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<p>This is a required parameter if you are adding a volume.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.MOVDATE"></a>
|
|
<h3>Last moved date (MOVDATE)</h3>
|
|
<p>Specifies the date of the last time this media volume was moved prior to being added to the media inventory.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>You are not assigning a last moved date for this media volume.
|
|
</dd>
|
|
<dt><b><i>move-date</i></b></dt>
|
|
<dd>Specify the date that this volume was last moved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.MOVPCY"></a>
|
|
<h3>Move policy (MOVPCY)</h3>
|
|
<p>Specifies the user-defined name of a move policy that you want to use for this volume.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>You are not assigning this volume a move policy.
|
|
</dd>
|
|
<dt><b><i>move-policy-name</i></b></dt>
|
|
<dd>Specify the name of the move policy that is to control the movement of this volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.EXPDATE"></a>
|
|
<h3>Expiration date (EXPDATE)</h3>
|
|
<p>Specifies the expiration date of the volume that is added to the media inventory. If a date is specified, the file is protected and cannot be overwritten until the expiration date.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The media is understood to contain no active data and can be used in backup or archive processing. Use *NONE when the volume is a new volume or when the volume is a previously used volume whose data is expired.
|
|
</dd>
|
|
<dt><b>*PERM</b></dt>
|
|
<dd>The media has a permanent retention and cannot be used in backup or archive processing.
|
|
</dd>
|
|
<dt><b><i>expiration-date</i></b></dt>
|
|
<dd>Specify the date after which data on the volume is considered to be non-essential and can be overwritten. The date must be specified in job date format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device that you want to use to initialize the specified volumes. The location of the device and the location of the MLB specified in the <b>Media library (MLB)</b> parameter must be the same.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MLB</u></b></dt>
|
|
<dd>Any device associated with the specified MLB can be used to initialize the specified volumes.
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the user-defined name of the device that you want to use to initialize the specified volumes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.NEWOWNID"></a>
|
|
<h3>New owner identifier (NEWOWNID)</h3>
|
|
<p>Specifies the volume owner's identifier to write in the volume label of the volume being written.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>The owner identification field is set to blanks.
|
|
</dd>
|
|
<dt><b><i>new-owner-identifier</i></b></dt>
|
|
<dd>Specify no more than 14 characters to identify the owner of the volume. If fewer than 14 characters are specified, the field is left-justified and is filled with blanks on the right.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.CHECK"></a>
|
|
<h3>Check for active files (CHECK)</h3>
|
|
<p>Specifies whether a labeled volume should be checked for active data files before it is initialized for use. If an unlabeled volume is placed in the specified device, this parameter is ignored.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>All data file labels on the volume are checked. If any active files are found, the operation is ended and an error message is sent.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>Only the first data file label on the volume is checked. If there are no data files on the volume or if the first data file has expired, the volume is initialized for use without checking for any other files on the volume. If the first data file has not expired, the operation is ended and an error message is sent.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Volume initialization continues with no checking for active files. To initialize a new or empty volume *NO must be specified here and *MOUNTED must be specified on the <b>Volume identifier (VOL)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.CODE"></a>
|
|
<h3>Code (CODE)</h3>
|
|
<p>Specifies the character code in which the volume label is written. All data that is not save/restore data written after the label must be in the same code; codes cannot be intermixed on a volume that is not a save/restore volume.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*EBCDIC</u></b></dt>
|
|
<dd>The volume label is written in EBCDIC and is an IBM standard label; all additional data must also be written in EBCDIC.
|
|
</dd>
|
|
<dt><b>*ASCII</b></dt>
|
|
<dd>The volume label is written in ASCII and is an American National Standard Institute standard label; all additional data must also be written in ASCII.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDMLMBRM.CLEAR"></a>
|
|
<h3>Clear (CLEAR)</h3>
|
|
<p>Specifies whether all labels and data are to be deleted from the volume when it is initialized for use. If the volume must be cleared of all data, it is deleted from the location of the volume label or tape marks to the end of the tape marker.
|
|
</p>
|
|
<p>This parameter is ignored if ADDVOL=*NO.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Existing data is not deleted. Even though the existing data is not deleted, the data on the volume is not usable after the volume has been initialized for use.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>After the beginning of the volume has been initialized for use, the remaining data on the volume is deleted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDMLMBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Adding a Volume to a Media Library</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDMLMBRM MLB(MLB01) VOL(T00001)
|
|
INZ(*NO) ADDVOL(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds volume T00001 to the media library MLB01, but the volume is not initialized. Volume T00001 must be a member of the BRMS media inventory.
|
|
</p>
|
|
<p><b>Example 2: Adding and Initializing a Volume to BRMS</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDMLMBRM MLB(MLB01) VOL(*INSERT)
|
|
INZ(*YES) MEDCLS(CART3490E)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds all volumes that are in the *INSERT category to the media library MLB01, and adds the volumes to the BRMS media inventory as media of class CART3490E. The volumes are initialized with the density specified in media class CART3490E.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDMLMBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>BRM1134</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>BRM1342</b></dt>
|
|
<dd>Volume identifier &2 not correct.
|
|
</dd>
|
|
<dt><b>BRM1707</b></dt>
|
|
<dd>Media library &1 not found or not defined.
|
|
</dd>
|
|
<dt><b>BRM1763</b></dt>
|
|
<dd>Device &1 cannot be used.
|
|
</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>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="#ADDMLMBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|