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

961 lines
37 KiB
HTML
Raw Permalink Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<!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 to BRM (ADDMEDBRM)</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="ADDMEDBRM.Top_Of_Page"></a>
<h2>Add Media to BRM (ADDMEDBRM)</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="#ADDMEDBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDMEDBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDMEDBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDMEDBRM"></a>
<p>The Add Media to BRM (ADDMEDBRM) command adds a media volume to the BRMS media inventory. The volume can be a volume from another media inventory that contains active data, the volume can be a volume from some other outside source, or a new volume that you want to initialize. Once added, BRMS tracks the volume's characteristics, location, use and content.
</p>
<p>When you add the volume, you must specify the media class of the volume. You can also specify how you want the volume to move, where the volume is located, its container (if any) and other miscellaneous attributes.
</p>
<p>If the numbering scheme of the volumes that you are adding is consecutive, the ADDMEDBRM command will automatically add the volumes without having to add the volumes one at a time.
</p>
<p>Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
</p>
<ul>
<li>The <b>Device (DEV) </b>parameter is limited on only one device or *MEDCLS special value for serial operations.
</li>
<li>Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
</li>
<li>*CHANGE authority is required to the image catalogs.
</li>
<li>Execute (*X) authority is required to each directory in the image catalog path name.
</li>
<li>Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
</li>
<li>*USE authority is required to the virtual devices using the image catalogs.
</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>i5/OS uses certain volume identifiers for special purposes. You should avoid using these volume identifiers in your volume labeling. Volume identifiers that you should avoid are:
<p>
<pre>
TAPxxx
NLTxxx
BLKxxx
CLNxxx
ERRxxx
SLTxxx
IMPxxx
</pre>
</p>
</li>
<li>To add a virtual volume, you must specify the name of an existing tape image catalog on the <b>Image catalog (IMGCLG)</b> parameter, These additional restrictions apply when adding virtual media:
<ul>
<li>The name specified for the <b>Volume identifier (VOL)</b> parameter must exist as a tape volume name in the image catalog entries.
</li>
<li>The density of the virtual volume (image catalog entry) must be the same as the density of the media class.
</li>
<li>You must specify 1 for <b>Number to add (VOLCNT)</b>. Virtual volumes can only be added individually.
</li>
<li>You must specify *LCL or the current system name for <b>System (SYSNAME)</b>. Virtual tape media resides in storage on the current system.
</li>
<li>Cleaning and volume statistic are not maintained for virtual tape media.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDMEDBRM.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="#ADDMEDBRM.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.MEDCLS"><b>MEDCLS</b></a></td>
<td valign="top">Media class</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.VOLCNT"><b>VOLCNT</b></a></td>
<td valign="top">Number to add</td>
<td valign="top">1-999, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.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="#ADDMEDBRM.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="#ADDMEDBRM.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="#ADDMEDBRM.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="#ADDMEDBRM.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Creation date</td>
<td valign="top"><i>Date</i>, <b><u>*CURRENT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.SLOT"><b>SLOT</b></a></td>
<td valign="top">Slot number</td>
<td valign="top">1-999999, <b><u>*NEXT</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.SYSNAME"><b>SYSNAME</b></a></td>
<td valign="top">System</td>
<td valign="top"><i>Name</i>, <b><u>*LCL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</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="#ADDMEDBRM.IMGCLG"><b>IMGCLG</b></a></td>
<td valign="top">Image catalog</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="#ADDMEDBRM.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.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="#ADDMEDBRM.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="#ADDMEDBRM.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="#ADDMEDBRM.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of tape option</td>
<td valign="top"><b><u>*REWIND</u></b>, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.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>
<tr>
<td valign="top"><a href="#ADDMEDBRM.NXTVOLMSG"><b>NXTVOLMSG</b></a></td>
<td valign="top">Next volume message</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.DLY"><b>DLY</b></a></td>
<td valign="top">Tape mount delay</td>
<td valign="top">1-900, <b><u>*DEV</u></b>, *IMMED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.LOC"><b>LOC</b></a></td>
<td valign="top">Location</td>
<td valign="top"><i>Name</i>, <b><u>*HOME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.CNR"><b>CNR</b></a></td>
<td valign="top">Container ID</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="#ADDMEDBRM.USECNT"><b>USECNT</b></a></td>
<td valign="top">Media uses</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.READERR"><b>READERR</b></a></td>
<td valign="top">Read errors</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.WRTERR"><b>WRTERR</b></a></td>
<td valign="top">Write errors</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.BYTEREAD"><b>BYTEREAD</b></a></td>
<td valign="top">Bytes read</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.BYTEWRT"><b>BYTEWRT</b></a></td>
<td valign="top">Bytes written</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.CURBYTES"><b>CURBYTES</b></a></td>
<td valign="top">Current bytes written</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.MAXBYTES"><b>MAXBYTES</b></a></td>
<td valign="top">Maximum bytes written</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.LASTCLN"><b>LASTCLN</b></a></td>
<td valign="top">Last clean date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDMEDBRM.USECLN"><b>USECLN</b></a></td>
<td valign="top">Uses since cleaning</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDMEDBRM.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies the identifier of the volume being added to the BRMS media inventory. If the volume is being added to a media class using a virtual density, the volume-identifier must match the <b>Tape volume name</b>of the image catalog entry.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the identifier of the volume being added to the media inventory. The volume identifier is a maximum of six characters in length. A volume cannot be added if its volume identifier already exists in the BRMS media inventory.
<p>
<b>Note: </b>Valid characters for the volume identifier are 0 - 9 and A - Z.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.MEDCLS"></a>
<h3>Media class (MEDCLS)</h3>
<p>Specifies the user-defined 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>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.VOLCNT"></a>
<h3>Number to add (VOLCNT)</h3>
<p>Specifies the number of volumes to add during this session. The value specified in the <b>Volume identifier (VOL)</b> parameter is increased by 1 for each volume added until the end of the count is reached. If the new volume identifier cannot be increased because of the way a volume is named, such as TAPEB9, an error message is sent.
</p>
<p>
<b>Note: </b>You can add a maximum of 999 volumes at a time, even though the field can hold up to 5 digits.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>Adds a single volume.
</dd>
<dt><b><i>number-to-add</i></b></dt>
<dd>Specify the number of volumes to add. For instance, specifying a "5" would add 5 volumes, each volume being increased by 1, such as T00001, T00002, T00003 and so on. The first volume (T00001 in the above example) is the volume specified in the <b>Volume identifier (VOL)</b> parameter. The maximum number of volumes that you can add at a time is 999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.INZ"></a>
<h3>Initialize tape (INZ)</h3>
<p>Specifies whether the volumes that you are adding are to be initialized.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The volume that you are adding is not to be initialized. This is used if the volume has been initialized outside of BRMS and contains active data. You can specify the expiration date for this volume in the <b>Expiration date (EXPDATE)</b> parameter.
</dd>
<dt><b>*YES</b></dt>
<dd>The volume is to be initialized with the ADDMEDBRM command and is to be added to the BRMS media inventory. The date in the <b>Expiration date (EXPDATE)</b> parameter is set to *NONE (all zeros).
<p>If you specify *YES for the <b>Initialize tape (INZ)</b> parameter, you must specify the <b>Device (DEV)</b> parameter. You must specify a device of category *VRTTAP if the media class uses a virtual density (*VRT32K *VRT64K *VRT240K *VRT256K).
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>Specifies the expiration date of the media 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>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The media is expired media and can be used in backup or archive processing. A value of *NONE means that the volume is a new volume that has been added to the media inventory or that the volume has been reinitialized.
</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 when protection for the media ends.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.MOVDATE"></a>
<h3>Last moved date (MOVDATE)</h3>
<p>Specifies the last date this volume was moved prior to being added to the media inventory.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>You are not assigning a last moved date for this 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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.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>
<b>Note: </b>Virtual media cannot be moved. Move policies are assigned to virtual volumes so the policy can be replicated to the output media when the virtual volume is duplicated.
</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 user-defined name of the move policy that you are assigning to this media volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.CRTDATE"></a>
<h3>Creation date (CRTDATE)</h3>
<p>Specifies the date that the first file on this volume was written.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>You are assigning the current date as the creation date for this volume.
</dd>
<dt><b><i>creation-date</i></b></dt>
<dd>Specify the date that this volume had data written on it. The date must be specified in job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.SLOT"></a>
<h3>Slot number (SLOT)</h3>
<p>Specifies the slot number for the volume that you have selected to add.
</p>
<dl>
<dt><b><u>*NEXT</u></b></dt>
<dd>Use the next available slot number if the specified location allows media slotting.
</dd>
<dt><b>*NONE</b></dt>
<dd>No slot is assigned to the volume that you are adding.
</dd>
<dt><b><i>slot-number</i></b></dt>
<dd>Specify the slot number that you are assigning to this volume. Slot numbers can be any number from 1 to 999999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.SYSNAME"></a>
<h3>System (SYSNAME)</h3>
<p>Specifies the system identifier for the volume that you are adding.
</p>
<dl>
<dt><b><u>*LCL</u></b></dt>
<dd>Specifies that the system is the local system. BRMS uses the default local location name, LCLLOCNAME and not the system name SYSNAME. In most cases, the systems have the same value specified in the LCLLOCNAME and in the SYSNAME. You can use the DSPNETA command to view the system network attributes.
</dd>
<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 use this value.
</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 use this value.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies text to describe the media that you are adding.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is no text associated with the volume that you are adding.
</dd>
<dt><b><i>text</i></b></dt>
<dd>Specify the text for the volume that you are adding.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.IMGCLG"></a>
<h3>Image catalog (IMGCLG)</h3>
<p>Specifies the name of the image catalog for a tape volume being added which is a virtual volume. The image catalog and image catalog entry for the volume being added must exist before you can add and initialize the virtual volumes.
</p>
<p>
<b>Note: </b>Use GO CMDCLG and GO CMDCLGE to view the menus for commands used to manage image catalogs and image catalog entries.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Specifies this is not a virtual volume.
</dd>
<dt><b><i>image-catalog</i></b></dt>
<dd>Specifies the name of the image catalog which contains the image catalog entry for a virtual volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the name of the tape device which is used to initialize the volume. The tape device you specify must be one whose category is *TAP or *TAPMLB as shown on the WRKDEVBRM display. This is a required parameter when *YES is specified in the <b>Initialize tape (INZ)</b> parameter. You must specify a device of category *VRTTAP if the media class uses a virtual density (*VRT32K *VRT64K *VRT240K *VRT256K).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.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>
<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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.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>
<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 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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.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>
<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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.ENDOPT"></a>
<h3>End of tape option (ENDOPT)</h3>
<p>Specifies whether the volume is only rewound, or rewound and unloaded after it has been initialized for use.
</p>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The volume is rewound after it has been initialized for use.
</dd>
<dt><b>*UNLOAD</b></dt>
<dd>The volume is rewound and unloaded.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.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 volume marks to the end of the volume marker.
</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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.NXTVOLMSG"></a>
<h3>Next volume message (NXTVOLMSG)</h3>
<p>Specifies whether you want BRMS to notify you through messages to place another volume on a device.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>BRMS will send you messages when the device is ready to accept another volume.
</dd>
<dt><b>*NO</b></dt>
<dd>You do not want BRMS to send you messages as soon as the device is ready to accept another volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.DLY"></a>
<h3>Tape mount delay (DLY)</h3>
<p>Specifies how long you want the device to delay before it begins processing the next volume on a device.
</p>
<dl>
<dt><b><u>*DEV</u></b></dt>
<dd>The device should begin processing the next volume based on the device default.
</dd>
<dt><b>*IMMED</b></dt>
<dd>The device should begin processing the next volume as soon as it finishes the previous volume.
</dd>
<dt><b><i>number-of-seconds</i></b></dt>
<dd>Specify the number of seconds that the device should wait before is begins processing the next volume. The number of seconds can range from 1 to 900.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.LOC"></a>
<h3>Storage location (LOC)</h3>
<p>Specifies the name of the storage location for the volume you are adding. Storage locations are used to hold media and containers. Storage locations can be local, that is, your computer room, or volume inventory or offsite, like a vault or vaulting service. Storage location names are user-defined.
</p>
<p>Storage locations are set up in the Work with Storage Locations display. The choices on the command reflect the locations that you have set up.
</p>
<dl>
<dt><b><u>*HOME</u></b></dt>
<dd>The volume is assigned to a location called *HOME.
</dd>
<dt><b><i>location-name</i></b></dt>
<dd>Specify the name of the storage location for this volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.CNR"></a>
<h3>Container ID (CNR)</h3>
<p>Specifies the name of a container to which you want to add this volume. The container must be of a class that can accommodate this type of media.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>You are not storing this volume in a container.
</dd>
<dt><b><i>container-ID-name</i></b></dt>
<dd>Specify the name of the container in which you are storing this volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.USECNT"></a>
<h3>Media uses (USECNT)</h3>
<p>Specifies the number of times that a media volume has been read from or written to. When the volume exceeds the usage threshold value for media in its media class, it should be taken out of service and replaced with a newer volume. The usage threshold value can be reviewed in the Work with Media Classes display. Media uses is expressed in number of uses.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the media uses as zero.
</dd>
<dt><b><i>media-uses</i></b></dt>
<dd>Specify a number of media uses.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.READERR"></a>
<h3>Read errors (READERR)</h3>
<p>Specifies the number of read errors that have been recorded for each media volume in the media inventory. When the number of read errors exceeds the value specified in the read error threshold for a volume's media class, the volume should be replaced with a new volume. The read error threshold value can be reviewed in the Work with Media Classes display. Read errors are expressed in kilobytes per read error.
</p>
<p>The following guidelines can be used to determine the <b>Read error threshold </b>value for your media class. If a volume or cartridge exceeds the criteria, copy the contents to a new volume and discard the old volume.
</p>
<dl>
<dt><b>3570</b></dt>
<dd>One temporary read error per 1000 megabytes read.
</dd>
<dt><b>3580</b></dt>
<dd>One temporary read error per 10 gigabytes read.
</dd>
<dt><b>3590</b></dt>
<dd>One temporary read error per 10 gigabytes read.
</dd>
<dt><b>3480 and 3490</b></dt>
<dd>One temporary read error per 50,000,000 KB read.
</dd>
<dt><b>1/4-Inch cartridge (6341, 6346, 6366 and 9346 and 6342 and 6347 at 10,000 bpi density)</b></dt>
<dd>One temporary read error per 12,500 KB read.
</dd>
<dt><b>1/4-Inch Cartridge (6342 and 6347 at 16,000 bpi density)</b></dt>
<dd>One temporary read error per 4,170 read.
</dd>
<dt><b>8-Millimeter cartridges (7208)</b></dt>
<dd>One temporary read error per 100 KB read.
</dd>
<dt><b>1/2-inch volume reel (9347)</b></dt>
<dd>One temporary read error per 50,000 KB read.
</dd>
<dt><b>1/2-inch tape reel (9348 and 2440)</b></dt>
<dd>One temporary read error per 100,000 KB read.
</dd>
<dt><b>1/2-inch tape reel (3422)</b></dt>
<dd>One temporary read error per 144,000 KB read.
<p>If all volumes used in a single drive exceed these criteria, the read/write heads are probably dirty. You should also discard tape reels and tape cartridges with a hard read error.
</p>
</dd>
</dl>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the read errors as zero.
</dd>
<dt><b><i>read-errors</i></b></dt>
<dd>Specify a number of read errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.WRTERR"></a>
<h3>Write errors (WRTERR)</h3>
<p>Specifies the number of write errors that have been recorded for each media volume in the media inventory. When the number of write errors exceeds the value specified in the write error threshold for a volume's media class, the volume should be replaced with a new volume. The write error threshold value can be reviewed in the Work with Media Classes display. Write errors are expressed in kilobytes per write error.
</p>
<p>The following guidelines can be used to determine the <b>Write error threshold </b>value for your media class. If a volume or cartridge exceeds the criteria, copy the contents to a new volume and discard the old volume.
</p>
<dl>
<dt><b>3570</b></dt>
<dd>One temporary write error per 250 GB written.
</dd>
<dt><b>3580</b></dt>
<dd>One temporary write error per 10 GB written.
</dd>
<dt><b>3590</b></dt>
<dd>One temporary write error per 1 GB written.
</dd>
<dt><b>3480 and 3490</b></dt>
<dd>One temporary write error per 12,500 KB written.
</dd>
<dt><b>1/4-Inch Cartridge (6341, 6346, 6366 and 9346 and 6342 and 6347 at 10,000 bpi density)</b></dt>
<dd>One temporary write error per 1,250 KB written.
</dd>
<dt><b>1/4-Inch Cartridge (6342 and 6347 at 16,000 bpi density)</b></dt>
<dd>One temporary write error per 890 KB written.
</dd>
<dt><b>8-Millimeter cartridges (7208)</b></dt>
<dd>One temporary write error per 50 KB written.
</dd>
<dt><b>1/2-inch tape reel (9347)</b></dt>
<dd>One temporary write error per 4,500 KB written.
</dd>
<dt><b>1/2-inch tape reel (9348 and 2440)</b></dt>
<dd>One temporary write error per 5,000 KB written for 1600 bpi. One temporary write error per 8,500 KB written for 6250 bpi.
</dd>
<dt><b>1/2-inch tape reel (3422)</b></dt>
<dd>One temporary write error per 8,500 KB written.
<p>If all tapes used in a single drive exceed these criteria, the read/write heads are probably dirty. You should also discard volumes and tape cartridges with a hard write error.
</p>
</dd>
</dl>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the write errors as zero.
</dd>
<dt><b><i>write-errors</i></b></dt>
<dd>Specify a number of write errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.BYTEREAD"></a>
<h3>Millions of bytes read (BYTEREAD)</h3>
<p>Specifies the number of bytes read (in millions of bytes) from the volume since its creation date.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the bytes read as zero.
</dd>
<dt><b><i>bytes-read</i></b></dt>
<dd>Specify a number of bytes read (in millions of bytes).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.BYTEWRT"></a>
<h3>Millions of bytes written (BYTEWRT)</h3>
<p>Specifies the number of bytes written (in millions of bytes) to the volume since its creation date.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the bytes written as zero.
</dd>
<dt><b><i>bytes-written</i></b></dt>
<dd>Specify a number of bytes written (in millions of bytes).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.CURBYTES"></a>
<h3>Current millions of bytes written (CURBYTES)</h3>
<p>Specifies the number of bytes currently written (in millions of bytes) on the media volume.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the current bytes written as zero.
</dd>
<dt><b><i>current-bytes-written</i></b></dt>
<dd>Specify a number of current bytes written (in millions of bytes).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.MAXBYTES"></a>
<h3>Maximum millions of bytes written (MAXBYTES)</h3>
<p>Specifies the maximum number of bytes (in millions of bytes) that can be written to this volume.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the maximum bytes written as zero.
</dd>
<dt><b><i>maximum-bytes-written</i></b></dt>
<dd>Specify a maximum number of bytes written (in millions of bytes).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.LASTCLN"></a>
<h3>Last clean date (LASTCLN)</h3>
<p>Specifies the last date that the media volume was cleaned.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No date is specified for the last cleaning date.
</dd>
<dt><b><i>last-cleaning-date</i></b></dt>
<dd>Specify the last date that the volume was cleaned.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDMEDBRM.USECLN"></a>
<h3>Uses since cleaning (USECLN)</h3>
<p>Specifies the number of uses since the last cleaning. When this number equals or exceeds the uses before cleaning parameter for this media class, the volume should be cleaned before using it further. The uses before cleaning value can be reviewed in the Work with Media Classes display.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>Initializes the uses since cleaning as zero.
</dd>
<dt><b><i>uses-since-cleaning</i></b></dt>
<dd>Specify a number of uses since cleaning.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDMEDBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Volume to BRMS</b>
</p>
<p>
<pre>
ADDMEDBRM VOL(T00001) MEDCLS(QIC1000)
</pre>
</p>
<p>This command adds volumes to the BRMS media inventory. In this example, volume T00001 is assigned a media class of QIC1000 and is added to the BRMS media inventory. The volume is not initialized and is added as expired.
</p>
<p><b>Example 2: Adding and Initializing a Volume to BRMS</b>
</p>
<p>
<pre>
ADDMEDBRM VOL(T00002) MEDCLS(QIC1000)
INZ(*YES) DEV(TAP01)
</pre>
</p>
<p>This command adds the volume T00002 to the BRMS media inventory with a media class of QIC1000. The volume is initialized using device TAP01.
</p>
<p><b>Example 3: Adding a Virtual Volume to BRMS</b>
</p>
<p>
<pre>
ADDMEDBRM VOL(VRT001) MEDCLS(VRT256K)
INZ(*YES) DEV(VRTTAP) IMGCLG(VRTIMGCLG)
</pre>
</p>
<p>This command adds the virtual volume VRT001 to the BRMS media inventory with a media class of VRT256K. The volume is initialized using device VRTTAP. Image catalog VRTIMGCLG contains the image catalog entry for VRT001.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDMEDBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1134</b></dt>
<dd>Device &amp;1 not found.
</dd>
<dt><b>BRM133E</b></dt>
<dd>Image catalog entry does not exist for virtual volume &amp;2.
</dd>
<dt><b>BRM133F</b></dt>
<dd>Image catalog does not exist for virtual volume &amp;2.
</dd>
<dt><b>BRM1713</b></dt>
<dd>Media class &amp;2 not found.
</dd>
<dt><b>BRM1717</b></dt>
<dd>Volume cannot be renamed &amp;1.
</dd>
<dt><b>BRM1762</b></dt>
<dd>Volume &amp;1 was not initialized.
</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 &amp;1.
</dd>
<dt><b>BRM4041</b></dt>
<dd>Access denied for user &amp;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="#ADDMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink