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

201 lines
7.5 KiB
HTML
Raw Permalink Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Copy Media Info for BRM (CPYMEDIBRM)</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="CPYMEDIBRM.Top_Of_Page"></a>
<h2>Copy Media Info for BRM (CPYMEDIBRM)</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="#CPYMEDIBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYMEDIBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYMEDIBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYMEDIBRM"></a>
<p>This command is typically used when you are bringing a system into a network of systems that share BRMS media inventory information. The Copy Media Information using BRM (CPYMEDIBRM) command copies media inventory information to a work file, or copies the contents of the work file to the media inventory.
</p>
<p>Using the CPYMEDIBRM command prior to adding the system name to a BRMS network allows you to save the contents of the current media inventory into the work file. After network synchronization is complete, you can use CPYMEDIBRM with OPTION (*FROMFILE) on the newly added system to copy the original media inventory information back into the media inventory. Information that is inconsistent with the system's new network level media inventory information will be reported but unresolved when OPTION(*FROMFILE) is used.
</p>
<p>The Media Merge report is produced when the CPYMEDIBRM command is processed. The report will indicate differences that have been diagnosed. The report, if printed, is written to printer file QP1AEN.
</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>Restriction: </b>
</p>
<ul>
<li>The BRMS Network feature (Option 1) is required to use this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYMEDIBRM.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="#CPYMEDIBRM.OPTION"><b>OPTION</b></a></td>
<td valign="top">Type of copy</td>
<td valign="top"><b><u>*TOFILE</u></b>, *FROMFILE</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CPYMEDIBRM.FILE"><b>FILE</b></a></td>
<td valign="top">File</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File</td>
<td valign="top"><i>Name</i>, <b><u>QA1AMED</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CPYMEDIBRM.CPYMEDI"><b>CPYMEDI</b></a></td>
<td valign="top">Copy media information</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="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYMEDIBRM.OPTION"></a>
<h3>Type of copy (OPTION)</h3>
<p>This command is designed to allow you to merge existing BRMS information from the current system with an existing network group of one or more systems.
</p>
<p>The command allows you to store temporary copies of the current systems BRMS information to a temporary file. After an Initialize BRM (INZBRM) command using the option *NETSYS is used, the stored temporary copies can be merged in with the BRMS information brought from the other system
</p>
<dl>
<dt><b><u>*TOFILE</u></b></dt>
<dd>You are copying media information from the media inventory to a work file. This option should be used before an INZBRM *NETSYS.
</dd>
<dt><b>*FROMFILE</b></dt>
<dd>You are copying media information from the work file to the media inventory. Information that is inconsistent with the system's new network level media inventory information will be reported but unresolved when OPTION(*FROMFILE) is used. This option should be used after an INZBRM *NETSYS.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYMEDIBRM.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the name of the work file that BRMS uses when it copies media inventory information.
</p>
<p><b>Qualifier 1: File</b>
</p>
<dl>
<dt><b><u>QA1AMED</u></b></dt>
<dd>The media inventory file is copied to or from this file depending on the value specified in the <b>File to copy (OPTION)</b> parameter.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Specify the name of the file that you want to use when copying the media inventory. If the file that you specify does not exist, BRMS will create it for you.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the file. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library name where the file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYMEDIBRM.CPYMEDI"></a>
<h3>Copy media information (CPYMEDI)</h3>
<p>Specifies whether you want to copy media information for the media inventory that you are copying.
</p>
<p>
<b>Note: </b>*NO should be specified if you are planning to attach your system to a network.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Media information is not copied.
</dd>
<dt><b>*YES</b></dt>
<dd>Media information is copied.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYMEDIBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Copying BRMS Media Information To a File</b>
</p>
<p>
<pre>
CPYMEDIBRM FILE(WORKFILE)
</pre>
</p>
<p>This command copies BRMS media information to a file called WORKFILE.
</p>
<p><b>Example 2: Copying BRMS Media Information From a File</b>
</p>
<p>
<pre>
CPYMEDIBRM OPTION(*FROMFILE) FILE(WORKFILE)
</pre>
</p>
<p>This command copies BRMS media information from a file called WORKFILE to the network media inventory.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYMEDIBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</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="#CPYMEDIBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink