314 lines
12 KiB
HTML
314 lines
12 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>Initialize Media using BRM (INZMEDBRM)</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="INZMEDBRM.Top_Of_Page"></a>
|
|
<h2>Initialize Media using BRM (INZMEDBRM)</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="#INZMEDBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#INZMEDBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#INZMEDBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="INZMEDBRM"></a>
|
|
<p>The Initialize Media using BRM (INZMEDBRM) command prepares media for use in the BRMS system. This command is used to initialize a volume with a standard volume label for standard label magnetic volume processing.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>It is recommended that you use the INZMEDBRM command in place of the i5/OS INZTAP command. To assure the protection of media, BRMS disables INZTAP CHECK(*NO) for users who do not have *SECADM, *SECOFR, *SERVICE or *SAVSYS authority. Unlike users of INZTAP, users of INZMEDBRM do not need these levels of authority in order to use the CHECK(*NO) option.
|
|
</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>This command should not be used by control group *EXIT item processing as results will be unpredictable.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="INZMEDBRM.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="#INZMEDBRM.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#INZMEDBRM.NEWVOL"><b>NEWVOL</b></a></td>
|
|
<td valign="top">New volume identifier</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#INZMEDBRM.MEDCLS"><b>MEDCLS</b></a></td>
|
|
<td valign="top">Media class</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#INZMEDBRM.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="#INZMEDBRM.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*MOUNTED</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#INZMEDBRM.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="#INZMEDBRM.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="#INZMEDBRM.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="#INZMEDBRM.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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="INZMEDBRM.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device which is used to initialize the volume. The device name must be defined in the BRMS device table.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.NEWVOL"></a>
|
|
<h3>New volume identifier (NEWVOL)</h3>
|
|
<p>Specifies the volume identifier for a volume being initialized for use as a BRMS volume.
|
|
</p>
|
|
<p>New volume identifier is a required field.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>new-volume-identifier</i></b></dt>
|
|
<dd>Specify the 6 character identifier of the new volume. The identifier must contain only alphanumeric characters (A through Z and 0 through 9), and cannot have a prefix or be filled with blanks.
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.MEDCLS"></a>
|
|
<h3>Media class (MEDCLS)</h3>
|
|
<p>The MEDCLS parameter defines the density used to format the volume. It does not define the media class the volume is assigned. Use the CHGMEDBRM command to change the media class assignment of the volume.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the existing volume identifier of the volume being initialized for use or indicates that the volume currently on the magnetic device should be initialized for use.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
|
<dd>Any labeled or unlabeled volume that is placed in the specified volume device is initialized for use. To initialize a new or empty volume for use, *MOUNTED must be specified, and *NO must be specified on the <b>Check for active files (CHECK)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the identifier of the labeled volume being initialized for use. This parameter value can be used only to initialize a volume for use that is already a labeled volume. If the volume on the specified device has a different volume identifier than the one specified or if it is an unlabeled volume, an error message is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.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 for use, *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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="INZMEDBRM.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>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The 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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INZMEDBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Initializing a Volume</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
INZMEDBRM DEV(TAP06) NEWVOL(T00004) MEDCLS(QIC1000)
|
|
</pre>
|
|
</p>
|
|
<p>This command initializes volume T00004 using device TAP06. The volume is assigned a media class of QIC1000 and initialized using the density specified by the QIC1000 media class.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="INZMEDBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>BRM1317</b></dt>
|
|
<dd>Volume &1 cannot be initialized now.
|
|
</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="#INZMEDBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|