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/dupmedbrm.htm

954 lines
40 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>Duplicate Media using BRM (DUPMEDBRM)</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="DUPMEDBRM.Top_Of_Page"></a>
<h2>Duplicate Media using BRM (DUPMEDBRM)</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="#DUPMEDBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DUPMEDBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DUPMEDBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DUPMEDBRM"></a>
<p>The Duplicate Media using BRM (DUPMEDBRM) command copies the contents of a single volume, a single volume in a media set, media set, or set of marked saved items to other volumes. You can specify the volumes which are to be duplicated, or specify a search be performed to identify the volumes or saved items which are to be duplicated. You can also resume a previous duplication operation which ended with errors.
</p>
<p>
<b>Note: </b>The tape devices do not have to support the same media classes. The media policy is specified in the DUPMEDBRM command.
</p>
<p>
<b>Note: </b>The density field in the file header labels are changed to reflect the true density.
</p>
<p>
<b>Note: </b>If you are using DUPMEDBRM to copy a file group, the output media assumes the group number of the input media. An exception to this is if a Set Media Controls using BRM (SETMEDBRM) command overrides the value for file group and type for the output volumes.
</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>The volumes to be copied must be active volumes, be members of the BRMS media inventory.
</li>
<li>If you are copying a media set in batch mode by specifying a volume of the media set in the VOL parameter, you <b><u>must</u></b> use the special value *SET in the FROMVOL parameter.
</li>
<li>You cannot duplicate TSM (ADSM) media using the DUPMEDBRM command.
</li>
<li>Devices whose category is *APPC or *NET cannot be used to duplicate data using the DUPMEDBRM command.
</li>
<li>You must have two tape drives to use this command. If the devices are shared devices, BRMS will vary the devices on for you. If the devices are not shared devices, you must vary them on.
</li>
<li>If you are using devices with optimum block size enabled, the optimum block size supported by the output device must be greater than or equal to the optimum block size of the input device.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DUPMEDBRM.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="#DUPMEDBRM.VOL"><b>VOL</b></a></td>
<td valign="top">From volume identifier</td>
<td valign="top"><i>Character value</i>, *LIST, *RESUME, *SCHHST, *SEARCH</td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.RSMKEY"><b>RSMKEY</b></a></td>
<td valign="top">Resume key</td>
<td valign="top">1-999999, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.FILEGRP"><b>FILEGRP</b></a></td>
<td valign="top">File group</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *NONE, *ARCGRP, *BKUGRP, *SYSGRP, *SYSTEM</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.GRPTYPE"><b>GRPTYPE</b></a></td>
<td valign="top">File group type</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *ARC, *BKU</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.SCHMEDCLS"><b>SCHMEDCLS</b></a></td>
<td valign="top">From 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="#DUPMEDBRM.FROMDEV"><b>FROMDEV</b></a></td>
<td valign="top">From device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.TODEV"><b>TODEV</b></a></td>
<td valign="top">To device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DUPMEDBRM.FROMSEQNBR"><b>FROMSEQNBR</b></a></td>
<td valign="top">From sequence number</td>
<td valign="top">Single values: *ALL<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Starting file sequence number</td>
<td valign="top">
1-16777215, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Ending file sequence number</td>
<td valign="top">
1-16777215, <b><u>*LAST</u></b>, *ONLY</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.TOSEQNBR"><b>TOSEQNBR</b></a></td>
<td valign="top">To sequence number</td>
<td valign="top"><b><u>1</u></b>, *END</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MEDPCY"><b>MEDPCY</b></a></td>
<td valign="top">To media policy</td>
<td valign="top"><i>Name</i>, <b><u>*SYSPCY</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.FROMVOL"><b>FROMVOL</b></a></td>
<td valign="top">Input volume list</td>
<td valign="top">Single values: <b><u>*VOL</u></b>, *SET<br>Other values (up to 300 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.FROMENDOPT"><b>FROMENDOPT</b></a></td>
<td valign="top">From device end option</td>
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.TOENDOPT"><b>TOENDOPT</b></a></td>
<td valign="top">To device end option</td>
<td valign="top"><b><u>*UNLOAD</u></b>, *LEAVE, *REWIND</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.FROMSYS"><b>FROMSYS</b></a></td>
<td valign="top">From system</td>
<td valign="top"><i>Character value</i>, <b><u>*LCL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.TOVOL"><b>TOVOL</b></a></td>
<td valign="top">To volume identifier</td>
<td valign="top">Single values: <b><u>*MOUNTED</u></b><br>Other values (up to 300 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.OBJDTL"><b>OBJDTL</b></a></td>
<td valign="top">Retain object detail</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">Expiration date</td>
<td valign="top"><i>Date</i>, <b><u>*MEDPCY</u></b>, *PERM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MOVPCY"><b>MOVPCY</b></a></td>
<td valign="top">Move policy</td>
<td valign="top"><i>Name</i>, <b><u>*MEDPCY</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MEDCLS"><b>MEDCLS</b></a></td>
<td valign="top">Media class</td>
<td valign="top"><i>Character value</i>, <b><u>*MEDPCY</u></b>, *SYSPCY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.LOC"><b>LOC</b></a></td>
<td valign="top">Location</td>
<td valign="top"><i>Name</i>, <b><u>*MEDPCY</u></b>, *ANY, *HOME</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.VOLSEC"><b>VOLSEC</b></a></td>
<td valign="top">Secure volume</td>
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MINVOL"><b>MINVOL</b></a></td>
<td valign="top">Required volumes</td>
<td valign="top">1-9999, <b><u>*MEDPCY</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MARKDUP"><b>MARKDUP</b></a></td>
<td valign="top">Mark volumes for duplication</td>
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.MARKHST"><b>MARKHST</b></a></td>
<td valign="top">Mark history for duplication</td>
<td valign="top"><b><u>*MEDPCY</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DUPMEDBRM.SAVMEDINF"><b>SAVMEDINF</b></a></td>
<td valign="top">Save media information</td>
<td valign="top"><b><u>*NONE</u></b>, *BKUPCY, *LIB, *OBJ</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DUPMEDBRM.VOL"></a>
<h3>From volume identifier (VOL)</h3>
<p>Specifies the volumes to be duplicated or the type of search used to identify volumes or saved items to be duplicated.
</p>
<p>This parameter can be used in conjunction with the <b>Input volume list (FROMVOL)</b> parameter to specify the volume or volumes that you want to copy. You can copy a single volume, volumes in a media set, a list of volumes or all volumes marked for duplication. If you want to copy a single volume or a single volume in a media set, specify the name of the volume that you want to copy in the VOL parameter and the special value *VOL in the FROMVOL parameter.
</p>
<p>
<b>Note: </b>If you are prompting the command, use F9 to display all command parameters before you specify a volume in the VOL parameter. The prompter will set the default value in the FROMVOL parameter to *VOL.
</p>
<p>For instance, if you are copying a volume T00009, which is not a member of a media set, you would prompt the command, press F9, then enter T00009 in the VOL parameter. The *VOL should be the default value displayed in the FROMVOL parameter.
</p>
<p>If the volume is a member of a media set you would follow the same procedure.
</p>
<p>If you are not sure if a volume is a member of a media set, enter the volume in the VOL parameter and press the Enter key. If the volume is a member of a media set, the volume identifiers of all volumes in the set will be displayed in the FROMVOL parameter.
</p>
<p>For instance, if you had a media set made up of T00001, T00002 and T00003 and you can enter T00002 in the VOL parameter and pressed the enter key. Volumes T00001, T00002 and T00003 would be displayed in the FROMVOL parameter. The volumes in the FROMVOL parameter cannot be changed at this point. This helps assure that you are duplicating all members of the set.
</p>
<p>An alternate method of copying a media set is to specify a volume contained in the media set in the VOL parameter and using the special value *SET for the FROMVOL parameter.
</p>
<p>You can specify *LIST in the VOL parameter to copy a list of volumes that you specify in the FROMVOL parameter.
</p>
<p>You can specify *SEARCH in the VOL parameter to search the media inventory for the marked volumes that are to be duplicated, or *SCHHST to search the history information for marked saved items to be duplicated. When using *SEARCH or *SCHHST the FROMVOL parameter is not used.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*LIST</b></dt>
<dd>Specify this special value to duplicate a list of active volumes that you specify. Enter the list of volumes that you want to duplicate in the FROMVOL parameter.
</dd>
<dt><b>*RESUME</b></dt>
<dd>Specify to resume history or media duplication operations which end with errors. Use the <b>Resume key (RSMKEY)</b> parameter to specify the duplication operation to be resumed.
<p>
<b>Note: </b>You must correct any errors which caused the duplication operation to end before you resume the duplication operation.
</p>
</dd>
<dt><b>*SCHHST</b></dt>
<dd>All saved items that are marked for duplication, and meet the specified search values are duplicated. Search values are specified by using the following parameters:
<ul>
<li><b>File group (FILEGRP)</b> parameter
</li>
<li><b>File group type (GRPTYPE)</b> parameter
</li>
<li><b>Media class (SCHMEDCLS)</b> parameter
</li>
<li><b>From system (FROMSYS)</b> parameter
</li>
</ul>
</dd>
<dt><b>*SEARCH</b></dt>
<dd>All active volumes that are marked for duplication, and meet the specified search values are duplicated. Search values are specified by using the following parameters:
<ul>
<li><b>File group (FILEGRP)</b> parameter
</li>
<li><b>File group type (GRPTYPE)</b> parameter
</li>
<li><b>Media class (SCHMEDCLS)</b> parameter
</li>
<li><b>From system (FROMSYS)</b> parameter
</li>
</ul>
</dd>
<dt><b><i>from-volume-identifier</i></b></dt>
<dd>Specify the name of the volume that you want to duplicate. The volume identifier that you specify must be a active volume that is in the BRMS media inventory.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.RSMKEY"></a>
<h3>Resume key (RSMKEY)</h3>
<p>Specifies the previous duplication operation to resume. You may want to resume a previous duplication if the operation ended with errors.
</p>
<p>A resume key is returned in the recovery text of diagnostic message BRM4137 for duplication operations which end with errors.
</p>
<p>A resume key for pending duplication of saved items is also displayed on the <b>Duplication</b> view of the Work with Media Information display. Use the Work with Media Information (WRKMEDIBRM) command to display the saved items, then use F11 to select the <b>Duplication</b> view.
</p>
<p>
<b>Note: </b>This parameter is required when *RESUME is specified for the <b>Volume (VOL)</b> parameter.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All pending duplications of saved items with resume keys are duplicated.
</dd>
<dt><b><i>1-999999</i></b></dt>
<dd>The pending duplication of saved items having the specified resume key are duplicated.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FILEGRP"></a>
<h3>File group (FILEGRP)</h3>
<p>Specifies the file group that you want search for and duplicate the volumes that contain the specified file group.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all file groups that meet the other specifications in the search.
</dd>
<dt><b>*ARCGRP</b></dt>
<dd>Include volumes that contain the default archive control group in the group of files to duplicate.
<p>
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
</p>
</dd>
<dt><b>*BKUGRP</b></dt>
<dd>Include volumes that contain the default backup user data control group in the group of files to duplicate.
</dd>
<dt><b>*SYSGRP</b></dt>
<dd>Include volumes that contain the default system data control group in the group of files to duplicate.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>Include volumes that contain the default backup entire system control group in the group of files to duplicate.
</dd>
<dt><b><i>file-group</i></b></dt>
<dd>Specify the name of the file group whose volume you want to be duplicated.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.GRPTYPE"></a>
<h3>File group type (GRPTYPE)</h3>
<p>Specifies the type of file group that you want to search for and duplicate the volumes that contain the specified file group type.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all file groups that meet the other specifications in the search.
</dd>
<dt><b>*ARC</b></dt>
<dd>The file group is an archive file group.
<p>
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
</p>
</dd>
<dt><b>*BKU</b></dt>
<dd>The file group is a backup file group.
</dd>
<dt><b><i>file-group-type</i></b></dt>
<dd>Specify the file group type that you want to include in the search.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.SCHMEDCLS"></a>
<h3>From media class (SCHMEDCLS)</h3>
<p>Specifies the media classes that you want to search for and duplicate the input volumes that are associated with the specified media class.
</p>
<p>This parameter is only used in conjunction with the <b>From volume identifier (VOL)</b> parameter when the special value *SEARCH is specified.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all media classes that meet the other specifications in the search.
</dd>
<dt><b><i>from-media-class</i></b></dt>
<dd>Specify the name of the media class that you want to duplicate.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FROMDEV"></a>
<h3>From device (FROMDEV)</h3>
<p>Specifies the device name from which the volume or volumes is copied.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.TODEV"></a>
<h3>To device (TODEV)</h3>
<p>Specifies the device name on which you are placing the volume that you want to copy to.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FROMSEQNBR"></a>
<h3>From sequence number (FROMSEQNBR)</h3>
<p>Specifies which data file sequence numbers are to be copied.
</p>
<p>
<b>Note: </b>If *ALL is specified for Starting file sequence number, or *FIRST for Starting file sequence number and *LAST for Ending file sequence number, then file sequences prior to *FIRST or after *LAST which do not reside in the history information for the volumes will not be duplicated.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All files are duplicated.
</dd>
</dl>
<p><b>Element 1: Starting file sequence number </b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>All files starting with the first file sequence are duplicated.
</dd>
<dt><b><i>file-sequence-number</i></b></dt>
<dd>Specify the starting file sequence number do be duplicated. The valid range of sequence numbers is 1 through 16777215. Only the files in the specified sequence number range are duplicated.
</dd>
</dl>
<p><b>Element 2: Ending file sequence number </b>
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>All files ending with the last file sequence are duplicated.
</dd>
<dt><b>*ONLY</b></dt>
<dd>Only the file specified in the starting file sequence is duplicated. If *ALL is specified in the first element, then this parameter is ignored.
</dd>
<dt><b><i>file-sequence-number</i></b></dt>
<dd>Specify the ending file sequence number of the range to be duplicated. The valid range of sequence numbers is 1 through 16777215.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.TOSEQNBR"></a>
<h3>To sequence number (TOSEQNBR)</h3>
<p>Specifies which sequence number the data files are to be copied to.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>The data files are copied to file sequence 1.
</dd>
<dt><b>*END</b></dt>
<dd>The data files are added to the logical end of tape. The next valid sequence number is used.
</dd>
<dt><b><i>file-sequence-number</i></b></dt>
<dd>Specify the sequence number in which the data file will be copied to. This value is not allowed if the device does not have overwriting capabilities and the value specified is not the next logical value to be used at the end of the logical tape volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MEDPCY"></a>
<h3>To media policy (MEDPCY)</h3>
<p>Specifies the media policy for the volumes to which you are copying.
</p>
<p>Media policies are used to determine:
</p>
<ul>
<li>The type of retention to use, such as days, date or version, for media used in control group processing.
</li>
<li>The move policy to use with this media policy.
</li>
<li>The media class to use.
</li>
<li>Whether or not to use save files.
</li>
<li>The type of retention to use, such as days or date for save files created in control group processing.
</li>
</ul>
<p>The media policy you specify must be a media policy that is in the BRMS media policy table.
</p>
<dl>
<dt><b><u>*SYSPCY</u></b></dt>
<dd>The media policy specified in the system policy is used as the value for media policy.
</dd>
<dt><b>*NONE</b></dt>
<dd>No media policy is specified for this duplication operation. Media policy values must be supplied from the command for each parameter that has a default of *MEDPCY.
</dd>
<dt><b><i>to-media-policy-name</i></b></dt>
<dd>Specify a media policy that has been set up in the BRMS. You can press F4 to get a list of these media policies.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FROMVOL"></a>
<h3>Input volume list (FROMVOL)</h3>
<p>Specifies the list of volumes that are to be copied. This parameter works in conjunction with the <b>From volume identifier (VOL)</b> parameter to specify the volume or volumes that you want to copy. You can copy a single volume, a set of volumes or a list of volumes. You can specify up to 300 volumes in the FROMVOL parameter.
</p>
<p>To copy a single volume, specify a volume in the VOL parameter and specify the special value *VOL in the FROMVOL parameter.
</p>
<p>
<b>Note: </b>If you are prompting the command, use F9 to display all command parameters before you specify a volume in the VOL parameter. The prompter will set the default value in the FROMVOL parameter to *VOL.
</p>
<p>If you are not sure if a volume is a member of a media set, enter the volume identifier in the VOL parameter and press the Enter key. If the volume is a member of a media set, the volume identifiers of all volumes in the set will be displayed in the FROMVOL parameter.
</p>
<p>If you specify *LIST in the VOL parameter, you can enter a list of volumes to copy in the FROMVOL parameter.
</p>
<p>If you specify *SEARCH in the VOL parameter, this parameter is not used.
</p>
<p>If you want to duplicate the volumes in a media set, specify a volume of the media set in the VOL parameter and specify *SET in the FROMVOL parameter. You <b><u>must</u></b> use this method to duplicate the volumes of a media set in a batch job.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*VOL</u></b></dt>
<dd>You want to copy a single volume that is specified in the VOL parameter. The *VOL special value is displayed but not used when the special value *SEARCH is specified in the VOL parameter.
</dd>
<dt><b>*SET</b></dt>
<dd>Specify this special value to copy all volumes in a media set when only one volume of the set is specified in the VOL parameter. If you are copying a media set in batch mode by specifying a volume of the media set in the VOL parameter, you <b><u>must</u></b> use the special value *SET in the FROMVOL parameter.
</dd>
</dl>
<p><b>Other values (up to 300 repetitions)</b>
</p>
<dl>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the volume identifiers of a list of active volumes, that you want to duplicate.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FROMENDOPT"></a>
<h3>From device end option (FROMENDOPT)</h3>
<p>Specifies whether the volume placed on the device specified on the <b>From device (FROMDEV)</b> parameter is rewound and unloaded after the operation completes.
</p>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The volume is automatically rewound, but not unloaded after the operation ends.
</dd>
<dt><b>*LEAVE</b></dt>
<dd>The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
</dd>
<dt><b>*UNLOAD</b></dt>
<dd>The volume is automatically rewound and unloaded after the operation ends.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.TOENDOPT"></a>
<h3>To device end option (TOENDOPT)</h3>
<p>Specifies whether the volume placed on the device specified on the <b>To device (TODEV)</b> parameter is rewound and unloaded after the operation is completed.
</p>
<dl>
<dt><b><u>*UNLOAD</u></b></dt>
<dd>The volume is rewound and unloaded after the operation is completed.
</dd>
<dt><b>*LEAVE</b></dt>
<dd>The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
</dd>
<dt><b>*REWIND</b></dt>
<dd>The volume is rewound after the operation is completed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.FROMSYS"></a>
<h3>From system (FROMSYS)</h3>
<p>Specifies the location and network identification of the system that owns the volumes you would like to duplicate. When specifying a remote system, the input and output volumes used in the operation will be owned by the specified system.
</p>
<p>
<b>Note: </b>Use the Display Network Attributes (DSPNETA) command to view the system network attributes.
</p>
<p>
<b>Note: </b>The BRMS Network feature (Option 1) is required to use this value if a value other than *LCL is specified.
</p>
<dl>
<dt><b><u>*LCL</u></b></dt>
<dd>Specifies that the from-system is the local system. BRMS uses the <b>Default local location name (LCLLOCNAME)</b> network attribute and not the <b>System name (SYSNAME)</b> network attribute to determine the current system name. In most cases, the systems have the same value specified for LCLLOCNAME as for SYSNAME.
</dd>
<dt><b><i>location-name</i></b></dt>
<dd>Specifies the <b>Default local location name (LCLLOCNAME)</b> network attribute of the remote system for the network operation. The current system <b>Local network ID (LCLNETID)</b> network attribute is used to connect with the remote system.
</dd>
<dt><b><i>network-id.location-name</i></b></dt>
<dd>Specifies the <b>Local network ID (LCLNETID)</b> and the <b>Default local location name (LCLLOCNAME)</b> network attributes of the remote system for the network operation. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the LCLNETID and cccccccc is the LCLLOCNAME.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.TOVOL"></a>
<h3>To volume identifier (TOVOL)</h3>
<p>Specifies the volume identifiers of the volumes to which data is being copied.
</p>
<p>The volume identifier that you specify must be a volume that is in the BRMS media inventory.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*MOUNTED</u></b></dt>
<dd>The volume identifier of the volume placed in the device specified on the <b>To device (TODEV)</b> parameter is used. If the source volume is a standard labeled volume and the volume placed in the device is not labeled or is initialized to the wrong density, the volume is reinitialized to the correct density using the volume identifier of the source volume currently placed in the device.
</dd>
</dl>
<p><b>Other values (up to 300 repetitions)</b>
</p>
<dl>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the volume identifier of the volumes to which data is being copied. When the end of a volume is reached, you will be able to reinitialize the volume using this volume identifier. If the volume contains the correct volume identifier but is in the wrong density, the volume will be reinitialized to the correct density. The volume identifier is saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.OBJDTL"></a>
<h3>Retain object detail (OBJDTL)</h3>
<p>This parameter has no function. Object detail, including member level detail for physical files, is always retained for duplicated media as long as object detail was available for the input volumes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>Specifies the expiration that you want to use for output volumes created as a result of this duplication operation.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*PERM</b></dt>
<dd>Output volumes from this duplication operation are assigned a permanent expiration.
</dd>
<dt><b><i>expiration-date</i></b></dt>
<dd>Specify an expiration date with or without date separators that will be assigned to output volumes from this duplication operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MOVPCY"></a>
<h3>Move policy (MOVPCY)</h3>
<p>Specifies the move policy that you want to use for output volumes created as a result of this duplication operation.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>There is not a move policy associated with the output volumes that are created as a result of this duplication operation.
</dd>
<dt><b><i>move-policy</i></b></dt>
<dd>Specify a move policy that will be assigned to output volumes from this duplication operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MEDCLS"></a>
<h3>Media class (MEDCLS)</h3>
<p>Specifies the media class that you want to use for output volumes created as a result of this duplication operation.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*SYSPCY</b></dt>
<dd>The value for media class in the system policy will be assigned to output volumes from this duplication operation.
</dd>
<dt><b><i>media-class</i></b></dt>
<dd>Specify a media class that will be assigned to output volumes from this duplication operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.LOC"></a>
<h3>Location (LOC)</h3>
<p>Specifies the location that you want to use for output volumes created as a result of this duplication operation.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*ANY</b></dt>
<dd>Any valid location is assigned to output volumes from this duplication operation.
</dd>
<dt><b>*HOME</b></dt>
<dd>The home location is assigned to output volumes from this duplication operation.
</dd>
<dt><b><i>location</i></b></dt>
<dd>Specify a location that will be assigned to output volumes from this duplication operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.VOLSEC"></a>
<h3>Secure volume (VOLSEC)</h3>
<p>Specifies whether you want to apply volume security to volumes in this media class. Volumes that are secured can only be read by users with the special authorities *ALLOBJ or *SAVSYS.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>Volume security has not been applied to this media class. Volumes that do not have volume security can be read by anyone.
</dd>
<dt><b>*YES</b></dt>
<dd>Only users with special authorities *ALLOBJ or *SAVSYS can read media volumes in this media class.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MINVOL"></a>
<h3>Required volumes (MINVOL)</h3>
<p>Specifies the minimum number of expired volumes that must be present before any duplication can be done using this media policy. The value can also be checked by user jobs using the Check Expired Media for BRM (CHKEXPBRM) command.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no check done to determine the minimum number of required volumes before a duplication operation begins.
</dd>
<dt><b><i>number-of-volumes</i></b></dt>
<dd>Specify the number of expired media volumes that must be available before any BRMS duplication operation will begin. The number can range from 1 to 9999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MARKDUP"></a>
<h3>Mark volumes for duplication (MARKDUP)</h3>
<p>Specifies whether to mark volumes for duplication after they have been duplicated.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>Do not mark volumes for duplication.
</dd>
<dt><b>*YES</b></dt>
<dd>Mark volumes for duplication.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.MARKHST"></a>
<h3>Mark history for duplication (MARKHST)</h3>
<p>Specifies whether to mark history items for duplication after they have been duplicated.
</p>
<dl>
<dt><b><u>*MEDPCY</u></b></dt>
<dd>The value for this parameter is the media policy that is specified in the <b>Media policy (MEDPCY)</b> parameter of this duplication command.
<p>
<b>Note: </b>If *NONE is specified in the <b>Media policy (MEDPCY)</b> parameter, you cannot specify *MEDPCY in this parameter.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>Do not mark the history items for duplication.
</dd>
<dt><b>*YES</b></dt>
<dd>Mark the history items for duplication.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DUPMEDBRM.SAVMEDINF"></a>
<h3>Save media information (SAVMEDINF)</h3>
<p>Specifies whether you want to automatically save the media information after duplication has run. The media information is the changes to the save history and volume information that occur during the duplication operation. You can specify whether the save history in the media information is saved at the library or object level.
</p>
<p>
<b>Note: </b>Object level saved history information can only be saved if object level or member level detail was retained when the objects were originally saved.
</p>
<p>
<b>Note: </b>The saved media information will be appended to the last output volume used for duplication.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Specifies you do not want media information saved after duplication has run.
</dd>
<dt><b>*BKUPCY</b></dt>
<dd>Specifies you want the Backup Policy to specify whether media information is saved after duplication has run. If this value is specified, the current value of the <b>Automatically backup media information </b>prompt on the Backup Policy will determine whether media information is saved when this command is run.
</dd>
<dt><b>*LIB</b></dt>
<dd>Specifies you want media information saved after the duplication has run, but you only want to save library level history information. With library level history information, you must know the object names to restore individual objects.
</dd>
<dt><b>*OBJ</b></dt>
<dd>Specifies you want media information saved after the duplication has run and you want to save object level history information. With object level history information, you can use BRMS to help you locate saved objects that you want to restore such as physical files or members.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DUPMEDBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Copying a Single Volume</b>
</p>
<p>
<pre>
DUPMEDBRM VOL(T00001) FROMDEV(TAP01)
TODEV(TAP03) FROMVOL(T00001)
</pre>
</p>
<p>This command duplicates volume T00001 using TAP01 as the from device and TAP03 as the to device. Because T00001 is not a member of a media set, the input list (FROMVOL) contains only T00001.
</p>
<p><b>Example 2: Duplicating a List of Volumes</b>
</p>
<p>
<pre>
DUPMEDBRM VOL(*LIST) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
MEDPCY(FMT3570) FROMVOL(VOL001 VOL002 VOL003)
</pre>
</p>
<p>This command duplicates volumes VOL001, VOL002 and VOL003 using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device using the media class in the FMT3570 media policy for the to volumes.
</p>
<p><b>Example 3: Duplicating a Volume Set</b>
</p>
<p>
<pre>
DUPMEDBRM VOL(VOL002) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
FROMVOL(*SET) MEDPCY(FMT3570)
</pre>
</p>
<p>This command duplicates all volumes in the volume set which contains VOL002 using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device using the media class in the FMT3570 media policy for the to volumes.
</p>
<p><b>Example 4: Duplicating All Marked Volumes for Another System</b>
</p>
<p>
<pre>
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
FROMSYS(SYSTEM_B)
</pre>
</p>
<p>If this command is run on SYSTEM_A, the command will search for all volumes marked for duplication owned by SYSTEM_B using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device. SYSTEM_A and SYSTEM_B are in a BRMS network and share the media library resources.
</p>
<p><b>Example 5: Resume a Previous Duplicate Media using BRM</b>
</p>
<p>
<pre>
DUPMEDBRM VOL(*RESUME) RSMKEY(123456)
</pre>
</p>
<p>This command resume a previous duplication operation which ended abnormally. The resume key <b>123456</b> was returned in message BRM4137 when the duplication operation ended with exception BRM4138.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DUPMEDBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM15A2</b></dt>
<dd>Volume &amp;1 cannot be duplicated by this system.
</dd>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</dd>
<dt><b>BRM1934</b></dt>
<dd>Media duplication not successful.
</dd>
<dt><b>BRM1936</b></dt>
<dd>No media found for duplication.
</dd>
<dt><b>BRM2338</b></dt>
<dd>Duplication completed with errors.
</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>BRM4138</b></dt>
<dd>Media duplication completed with errors.
</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="#DUPMEDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink