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

407 lines
14 KiB
HTML
Raw Normal View History

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>Change Media using BRM (CHGMEDBRM)</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="CHGMEDBRM.Top_Of_Page"></a>
<h2>Change Media using BRM (CHGMEDBRM)</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="#CHGMEDBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGMEDBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGMEDBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGMEDBRM"></a>
<p>The Change Media using BRM (CHGMEDBRM) command changes an attribute or several attributes of a media volume in the BRMS media inventory.
</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>Restrictions: </b>
</p>
<ol>
<li>Consideration should be given to changing the authority to the CHGMEDBRM command from PUBLIC(*CHANGE) to a more restrictive authority to assure that changes are not made to media without proper authorization.
</li>
<li>These following restrictions apply for changing virtual tape volumes.
<ul>
<li>The density of the virtual volume (image catalog entry) must be the same as the density of the media class.
</li>
<li>Virtual tape media must reside in storage on the current system.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGMEDBRM.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="#CHGMEDBRM.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.MEDCLS"><b>MEDCLS</b></a></td>
<td valign="top">Media class</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">Expiration date</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, *PERM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.MOVDATE"><b>MOVDATE</b></a></td>
<td valign="top">Last moved date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.MOVPCY"><b>MOVPCY</b></a></td>
<td valign="top">Move policy</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Creation date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.VOLSEC"><b>VOLSEC</b></a></td>
<td valign="top">Secure volume</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.SLOT"><b>SLOT</b></a></td>
<td valign="top">Slot number</td>
<td valign="top">1-999999, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.SYSNAME"><b>SYSNAME</b></a></td>
<td valign="top">System</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *LCL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMEDBRM.IMGCLG"><b>IMGCLG</b></a></td>
<td valign="top">Image catalog</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGMEDBRM.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies the volume identifier of the volume being changed in the BRMS media inventory.
</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 changed in the media inventory. The volume identifier is a maximum of six characters in length.
<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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.MEDCLS"></a>
<h3>Media class (MEDCLS)</h3>
<p>Specifies the user-defined name of a media class for the volume you are changing. Media classes can be reviewed in the Work with Media Classes display.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>Use the same value as is currently assigned to the parameter.
</dd>
<dt><b><i>media-class</i></b></dt>
<dd>Specify the media class to which you want to change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>Specifies the expiration date of the media volume that is changed in the media inventory. If a date is specified, the file is protected and cannot be overwritten until the expiration date.
</p>
<p>Changing the expiration date of a volume will change the expiration date for all entries that contain data on that volume. If the data for an entry spans multiple volumes, the expiration date for those volumes may also change. The other volumes expiration dates will change only if the changed date is further in the future or the changed entry is the only entry having data on that volume.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The expiration date currently assigned to the media is not changed.
</dd>
<dt><b>*NONE</b></dt>
<dd>The media is expired media and can be used in backup or archive processing.
</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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.MOVDATE"></a>
<h3>Last moved date (MOVDATE)</h3>
<p>Specifies the last date that this media volume was moved.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the last moved date currently assigned to the volume.
</dd>
<dt><b>*NONE</b></dt>
<dd>You are not assigning a last moved date for this media volume.
</dd>
<dt><b><i>last-moved-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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.MOVPCY"></a>
<h3>Move policy (MOVPCY)</h3>
<p>The user-defined name of a move policy that you want change 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>*SAME</u></b></dt>
<dd>You want to use the same move policy as is currently assigned to the volume.
</dd>
<dt><b>*NONE</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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.CRTDATE"></a>
<h3>Creation date (CRTDATE)</h3>
<p>Specifies the date that this volume had data written on it.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the creation date currently assigned to the volume.
</dd>
<dt><b><i>creation-date</i></b></dt>
<dd>Specify the date that this volume had data written on it.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.VOLSEC"></a>
<h3>Secure volume (VOLSEC)</h3>
<p>Specifies whether you want to change who has access to this volume.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the accessibility of the volume.
</dd>
<dt><b>*NO</b></dt>
<dd>This volume is not secured.
</dd>
<dt><b>*YES</b></dt>
<dd>This volume is secured. Only users with special authorities *ALLOBJ or *SAVSYS can read this volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.SLOT"></a>
<h3>Slot number (SLOT)</h3>
<p>Specifies the slot number for the volume that you have selected to change.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the slot number currently assigned to the volume.
</dd>
<dt><b>*NONE</b></dt>
<dd>No slot number is assigned to the volume that you are changing.
</dd>
<dt><b><i>slot-number</i></b></dt>
<dd>Specify the slot number that you are assigning to this volume. Slot numbers can range from 1 to 999999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.SYSNAME"></a>
<h3>System (SYSNAME)</h3>
<p>Specifies the system identifier for the volume that you have selected to change.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the system identifier currently assigned to the volume.
</dd>
</dl>
<dl>
<dt><b>*LCL</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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies text to describe the media that you are changing.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>You are not going to change the text that describes the volume.
</dd>
<dt><b>*NONE</b></dt>
<dd>No text is specified to describe this volume.
</dd>
<dt><b><i>text</i></b></dt>
<dd>Specify text that describes the volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMEDBRM.IMGCLG"></a>
<h3>Image catalog (IMGCLG)</h3>
<p>Specifies the image catalog name for the tape volume which is being changed. If an image catalog name is specified, the image catalog and image catalog entry for the volume must exist to use the volume.
</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>*SAME</u></b></dt>
<dd>Use the same value as is currently assigned to the parameter.
</dd>
<dt><b>*NONE</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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMEDBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing a Volume in BRMS</b>
</p>
<p>
<pre>
CHGMEDBRM VOL(T00001) MEDCLS(QIC1000)
EXPDATE(*PERM) MOVDATE('2/12/03')
</pre>
</p>
<p>This command changes the media information for volume T00001. The media class has been changed to QIC1000, the expiration date has been changed to *PERM and the last moved date has been changed to February 12, 2003.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMEDBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1147</b></dt>
<dd>Volume &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>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>
<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="#CHGMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>