566 lines
26 KiB
HTML
566 lines
26 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 BRMS (INZBRM)</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="INZBRM.Top_Of_Page"></a>
|
||
|
|
<h2>Initialize BRMS (INZBRM)</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="#INZBRM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#INZBRM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#INZBRM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="INZBRM"></a>
|
||
|
|
<p>The Initialize BRMS (INZBRM) command performs several types of initialization. These are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Allows you to estimate the time to update the BRMS product to a future version and release.
|
||
|
|
</li>
|
||
|
|
<li>Allows you to start BRMS product initialization after installation or update.
|
||
|
|
</li>
|
||
|
|
<li>Allows you to estimate the time remaining to complete BRMS product initialization.
|
||
|
|
</li>
|
||
|
|
<li>Initializes all major files as well as establishing default policies and control groups
|
||
|
|
</li>
|
||
|
|
<li>Starts the subsystem for networking in a multi-system environment
|
||
|
|
</li>
|
||
|
|
<li>Allows you to reset BRMS and re-initialize all major files as well as establishing default policies and control groups
|
||
|
|
</li>
|
||
|
|
<li>Creates auxiliary storage pool (ASP) descriptions
|
||
|
|
</li>
|
||
|
|
<li>Allows you to re-register all BRMS functional authority elements with the i5/OS registration facility. This option is used during a full system recovery prior to restoring user profiles
|
||
|
|
</li>
|
||
|
|
<li>Allows you to change the system name for BRMS media information to a new system name when restoring this information to a different system or logical partition
|
||
|
|
</li>
|
||
|
|
<li>Allows you to merge the BRMS database files contained on one library with the BRMS database files in another library
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The INZBRM command is used to add a system to a BRMS network group. The INZBRM command must be processed from the system that you are adding to the network group.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>All references to system name assume that the system name and the system location name are the same and are used interchangeably in the help information. If they are not the same, use the system location name instead of the system name. You can review the setting for the system name and location name by using the Display Network Attributes (DSPNETA) command from any command line.
|
||
|
|
</p>
|
||
|
|
<p>Systems that are members of the network group share BRMS media inventory. Additions, changes and removals from shared media inventory on any system in the network result in the same changes being made to all systems that are members of the network group.
|
||
|
|
</p>
|
||
|
|
<p>When a system is added to a network group, the media information common to the network group is copied to the system that you are adding. The system's media information is replaced by the network group's media information.
|
||
|
|
</p>
|
||
|
|
<p>When a system is first added, it is added in an inactive status on an active network group member.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This is accomplished by adding the system to a network group list using the Change Network Group display which is found in the System Policy menu. When the system name is added to the list, it is shown in inactive status.
|
||
|
|
</p>
|
||
|
|
<p>The INZBRM OPTION(*NETSYS) option changes the status from inactive to active and synchronizes media information.
|
||
|
|
</p>
|
||
|
|
<p>The following shared BRMS information files are replaced on this system with the information from the incoming system:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Media inventory
|
||
|
|
</li>
|
||
|
|
<li>Media classes
|
||
|
|
</li>
|
||
|
|
<li>Media policies
|
||
|
|
</li>
|
||
|
|
<li>Container inventory
|
||
|
|
</li>
|
||
|
|
<li>Container classes
|
||
|
|
</li>
|
||
|
|
<li>Move policies
|
||
|
|
</li>
|
||
|
|
<li>Network systems
|
||
|
|
</li>
|
||
|
|
<li>Storage locations
|
||
|
|
</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>
|
||
|
|
<li>All BRMS operations must be ended before running this command.
|
||
|
|
</li>
|
||
|
|
<li>All object authority is required to run the *RUNPRDINZ option.
|
||
|
|
</li>
|
||
|
|
<li>These additional restrictions apply when *MERGE is specified for the <b>Option (OPTION) </b>parameter:
|
||
|
|
<ul>
|
||
|
|
<li>All BRMS operations must be ended if library QUSRBRM is specified for the <b>To library (TOLIB) </b>parameter.
|
||
|
|
</li>
|
||
|
|
<li>Ownership of the from library and its objects and the to library and its objects will be changed to QBRMS prior to the merge. The public authority will be changed to *USE.
|
||
|
|
</li>
|
||
|
|
<li>Exclusive locks will be placed on the physical files in the from library objects and to library objects prior to the merge.
|
||
|
|
</li>
|
||
|
|
<li>Logical files will be deleted from the from library and to libraries prior to the merge.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="INZBRM.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="#INZBRM.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top"><b><u>*DATA</u></b>, *CHGSYSNAM, *DEVICE, *ESTPRDINZ, *ESTPRDUPD, *MERGE, *NETSYS, *RESET, *RUNPRDINZ, *SETAUT</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.FROMSYS"><b>FROMSYS</b></a></td>
|
||
|
|
<td valign="top">From system</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.PRVSYSNAM"><b>PRVSYSNAM</b></a></td>
|
||
|
|
<td valign="top">Previous system name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, *LCL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.NEWSYSNAM"><b>NEWSYSNAM</b></a></td>
|
||
|
|
<td valign="top">New system name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, *LCL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.FROMLIB"><b>FROMLIB</b></a></td>
|
||
|
|
<td valign="top">From library</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.MERGE"><b>MERGE</b></a></td>
|
||
|
|
<td valign="top">Merge</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 5 repetitions): *ARC, *BKU, *DEV, *HST, *MED, *MGR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.TOLIB"><b>TOLIB</b></a></td>
|
||
|
|
<td valign="top">To library</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#INZBRM.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="INZBRM.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies which of the types of initialization you want to perform.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DATA</u></b></dt>
|
||
|
|
<dd>You are initializing BRMS. Default control groups, policies and tables are built based on the characteristics of the system that is being initialized. Additionally, new devices are added and ASPs are configured. Default ASP descriptions for ASPs defined to the system, but not already defined to BRMS are added.
|
||
|
|
<p>When ASPs are configured, the following default information is added:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>ASP name value is *NONE, with the exception of ASP 1, which is given the ASP name of *SYSTEM.
|
||
|
|
</li>
|
||
|
|
<li>Low and high threshold values are set to *NONE.
|
||
|
|
</li>
|
||
|
|
<li>Text is "Entry created by BRM configuration".
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If the parameter contains the special value *DATA, you must process the INZBRM command on the system on which you want to initialize for BRMS.
|
||
|
|
</p>
|
||
|
|
<p>This option does not affected the saved history.
|
||
|
|
</p>
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHGSYSNAM</b></dt>
|
||
|
|
<dd>Allows you to change the system name stored in the BRMS media information. The system name is used to distinguish the media information of this system from the media information of other systems in a BRMS network. The system name is applied to the media information even if you do not use the BRMS networking feature. BRMS uses the system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the system name. You can use the DSPNETA command to view these system network attributes.
|
||
|
|
<p>You must change the system name of the media information to the current system name when recovering the BRMS media information to a different system or different logical partition having a system name different from the saved system name. You must specify a previous system name using the <b>Previous system name (PRVSYSNAM)</b> parameter and a new system name using the <b>New system name (NEWSYSNAM)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>The <b>From library (FROMLIB) </b>, <b>To library (TOLIB) </b>and <b>Merge (MERGE)</b> parameters are not used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEVICE</b></dt>
|
||
|
|
<dd>You are clearing device and media library information and re-initializing the files with the devices currently described on the system. In addition to clearing and re-initializing the device file, *DEVICE also performs the same functions as *DATA. Using the *DEVICE special value causes CSI objects and APPC device information to be removed from the BRMS inventory if no APPC device entries by the same name are found. Using the *DEVICE special value does not cause NET device information to be removed.
|
||
|
|
<p>This option does not affected the saved history.
|
||
|
|
</p>
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ESTPRDINZ</b></dt>
|
||
|
|
<dd>Use this option to determine the approximate time required to complete initialization of the BRMS program product after installation or update. An estimate of the initialization time is returned in message BRM402B. For more precise estimates, always run this option in the same system environment as the initialization job. If this option is run concurrently with product initialization, the approximate time remaining is returned.
|
||
|
|
<p>Product initialization is only required once following a product update. Use option *RUNPRDINZ of this command to run product initialization after the update.
|
||
|
|
</p>
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ESTPRDUPD</b></dt>
|
||
|
|
<dd>Use this option to determine the approximate time required to complete a BRMS program product update to a future version and release. The time estimate is returned in message BRM402C.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The actual time could vary from the estimated time if the update occurs on a different system or uses a different job environment.
|
||
|
|
</p>
|
||
|
|
<p>You must specify a value for <b>Target release (TGTRLS)</b> when using this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MERGE</b></dt>
|
||
|
|
<dd>Allows you to merge the BRMS database files contained in one library specified on the <b>From library (FROMLIB)</b> parameter with the BRMS database files in another library specified on the <b>To library (TOLIB)</b> parameter using options specified on the <b>Merge (MERGE)</b> parameter. This function may be useful when consolidating multiple systems onto a single system, or copying BRMS objects from library QUSRBRM to another library for subsequent archive. Refer to Appendix A in the Backup Recovery and Media Services book for additional guidance on using this option.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Because of the extensive file processing involved in the merge operation, this could be a long running process depending on the merge options you select and the size of the merged files.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you intend to merge more than one library to the current system it is recommended that you merge these libraries to an intermediate library then perform a final merge of the intermediate library into the QUSRBRM library.
|
||
|
|
</p>
|
||
|
|
<p>The <b>From system (FROMSYS)</b>, <b>Previous system name (PRVSYSNAM)</b> and <b>New system name (NEWSYSNAM) </b>parameters are not used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NETSYS</b></dt>
|
||
|
|
<dd>BRMS files will be copied from the system specified in the <b>From system (FROMSYS)</b> parameter which should be in the network system group. Prior to using this option, use the Copy Media Information (CPYMEDIBRM) command to copy the current BRMS information from this system to a temporary file. After the INZBRM *NETSYS is complete, to merge the old information, use the CPYMEDIBRM again to copy the information back from the temporary file. This option will replace data in some current BRMS files.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to use this value.
|
||
|
|
</p>
|
||
|
|
<p>Only the <b>From system (FROMSYS)</b> parameters is used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RESET</b></dt>
|
||
|
|
<dd>You are resetting BRMS. When you use this option BRMS information is removed from your system and all major files are re-initialized. Using OPTION(*RESET) clears all major BRMS files and processes the INZBRM command OPTION(*DATA). This option erases all hierarchial storage management (HSM) information and resets all configurations to be consistent with those created when the product is first installed. Since APPC information is not automatically configured by BRMS, *RESET removes all APPC device information from BRMS including any CSI objects that may have been created.
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RUNPRDINZ</b></dt>
|
||
|
|
<dd>Use this option to complete initialization of the BRMS program product after installation. The BRMS program product cannot be used until initialization is complete. Product initialization is only required once following a product update. Use this option if you receive message <b>BRM40A2 - BRMS product initialization required </b> when attempting to perform a BRMS operation after a product update.
|
||
|
|
<p>BRMS product initialization can be a long running process. Performance can be optimized by running this option when there is little or no other activity on the server.
|
||
|
|
</p>
|
||
|
|
<p>Use option *ESTPRDINZ of this command to retrieve an approximation of the time required to perform the initialization in the current environment.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>All object authority is required to use this option.
|
||
|
|
</p>
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SETAUT</b></dt>
|
||
|
|
<dd>Allows you to re-register all BRMS functional authority elements with the i5/OS registration facility. This option is used during a full system recovery prior to restoring user profiles.
|
||
|
|
<p>No parameters are used with this option.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.FROMSYS"></a>
|
||
|
|
<h3>From system (FROMSYS)</h3>
|
||
|
|
<p>Specifies the name of any system which is already in the network group that you want the new system to join. The network media information on the system that you specify here is copied to your system. For example, if system A is a system that you want to add to the network and system B is an active member of a network group, you would specify system B in the <b>From system (FROMSYS)</b> parameter. The network media inventory from system B replace the media inventory on system A and system A has now become an active member of the network group.
|
||
|
|
</p>
|
||
|
|
<p>The following media inventory files are copied from the active system in a network group to replace the media inventory files on the inactive system. You are notified before each file is replaced:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Media inventory
|
||
|
|
</li>
|
||
|
|
<li>Media classes
|
||
|
|
</li>
|
||
|
|
<li>Media policies
|
||
|
|
</li>
|
||
|
|
<li>Container inventory
|
||
|
|
</li>
|
||
|
|
<li>Container classes
|
||
|
|
</li>
|
||
|
|
<li>Move policies
|
||
|
|
</li>
|
||
|
|
<li>Network systems
|
||
|
|
</li>
|
||
|
|
<li>Storage locations
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The BRMS Network feature (Option 1) is required to use this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>location-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the remote location associated with the from-system. The local system's network identifier, as seen by using the DSPNETA command, is used as the from-system's network identifier.
|
||
|
|
</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 from-system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.PRVSYSNAM"></a>
|
||
|
|
<h3>Previous system name (PRVSYSNAM)</h3>
|
||
|
|
<p>Specifies the previous name of the system when changing the system name in the media information for recovery to a different system or different logical partition.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LCL</b></dt>
|
||
|
|
<dd>Specifies that the local system name is to be used for the previous system name. BRMS will use this system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the previous system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>previous-system-name</i></b></dt>
|
||
|
|
<dd>Specifies the name that is to be used as the previous system name . If you specify this value, BRMS will use the local network ID (LCLNETID) and the specified name to create the previous system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-id.location-name</i></b></dt>
|
||
|
|
<dd>Specify the local network identifier and default local location name that is to be used for the previous system name. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name of the previous system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.NEWSYSNAM"></a>
|
||
|
|
<h3>New system name (NEWSYSNAM)</h3>
|
||
|
|
<p>Specifies the new name of the system when changing the system name in the media information for recovery to a different system or different logical partition.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LCL</b></dt>
|
||
|
|
<dd>Specifies that the local system name is to be used for the new system name. BRMS will use this system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the new system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>new-system-name</i></b></dt>
|
||
|
|
<dd>Specifies the name that is to be used as the new system name . If you specify this value, BRMS will use the local network ID (LCLNETID) and the specified name to create the new system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-id.location-name</i></b></dt>
|
||
|
|
<dd>Specify the local network identifier and default local location name that is to be used for the new system name. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name of the new system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.FROMLIB"></a>
|
||
|
|
<h3>From library (FROMLIB)</h3>
|
||
|
|
<p>Specifies the name of the source library containing the BRMS files with the records to be merged. This should be a version of the QUSRBRM library saved from another system and restored to the current system using a different library name.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Prior to the start of the merge operation, the ownership of the library and all objects in the library will be changes to QBRMS and the public authority will be changed to *USE. Also, all logical files will be deleted from this library and all physical files will be converted to the current release.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>from-library-name</i></b></dt>
|
||
|
|
<dd>Name of the library containing the BRMS database files which are to be merged. Library QUSRBRM cannot be specified as the from library.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.MERGE"></a>
|
||
|
|
<h3>Merge (MERGE)</h3>
|
||
|
|
<p>Specifies the options for the merge process. These options define the types of BRMS data to be merged.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Specifies all BRMS media, device, history and policy files are to be merged.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 5 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ARC</b></dt>
|
||
|
|
<dd>Specifies all BRMS archive control group and archive list files are to be merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BKU</b></dt>
|
||
|
|
<dd>Specifies all BRMS backup control group and backup list files are to be merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEV</b></dt>
|
||
|
|
<dd>Specifies all BRMS user devices such as Tivoli Storage Manager (TSM) of type *NET and user media library devices of type *USRMLB are to be merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HST</b></dt>
|
||
|
|
<dd>Specifies all BRMS media information files containing backup, archive and migration history are to be merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MED</b></dt>
|
||
|
|
<dd>Specifies all BRMS volume information and media related files are to be merged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MGR</b></dt>
|
||
|
|
<dd>Specifies all BRMS migration control group files are to be merged.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.TOLIB"></a>
|
||
|
|
<h3>To library (TOLIB)</h3>
|
||
|
|
<p>Specifies the name of the target library containing the BRMS files which will receive the merge records.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Always save library QUSRBRM before performing a merge operation when QUSRBRM is specified for the to library.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You must end all BRMS operations before performing a merge operation when QUSRBRM is specified for the to library. The merge operation will fail if exclusive locks cannot be obtain ed for the files in the to library.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>to-library-name</i></b></dt>
|
||
|
|
<dd>Name of the library containing the BRMS database files which will receive the merge records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="INZBRM.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the target release for estimating the BRMS product update time. This is a required parameter when *ESTPRDUPD is specified for the <b>Option (OPTION) </b>parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEFAULT</b></dt>
|
||
|
|
<dd>Specifies the default action is to be used when estimating the BRMS product update time. The default action assumes the target release is not available and a worst case update time is returned. Use this value if a future version and release of the product is not available, or the current version and release is no longer serviced and an available target release is not listed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>target-release</i></b></dt>
|
||
|
|
<dd>Specify the target release for the update in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R4M0 is version 5, release 4, modification level 0.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="INZBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Initializing the BRMS Product</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*RESET)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command initializes BRMS resetting all values to the default value.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Activating a System on the Network</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*NETSYS) FROMSYS(MYNETID.MYSYSID)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command activates system MYSYSID on network MYNETID into the BRMS network. The command is run on system MYSYSID.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Register All Functional Authorities</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*SETAUT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command registers all policies and functions currently defined in BRMS to the i5/OS Registration facility.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Rename Media Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*CHGSYSNAM) PRVSYSNAM(MYNETID.MYSYSID) NEWSYSNAM(*LCL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command renames all BRMS media information currently owned by system MYSYSID on network MYNETID to the local network identified and default local location name as defined in the network attributes.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Merge BRMS Database Files</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*MERGE) FROMLIB(QUSRBRMSAV) TOLIB(QUSRBRM) MERGE(*ALL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command merges the records found in the database files found in library QUSRBRMSAV with the records found in library QUSRBRM.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Estimate BRMS initialization</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*ESTPRDINZ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command estimates the time required to initialize BRMS following installation of the product primary language. The estimate is returned in message BRM402B.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Run BRMS initialization</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*RUNPRDINZ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The user has received exception BRM40A2 trying to run BRMS operations. This command completes the BRMS product initialization and allows for normal BRMS operations to continue.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 8: Estimate BRMS update time</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
INZBRM OPTION(*ESTPRDUPT) TGTRLS(VxRxMx)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Estimates the time to update the current version and release of BRMS to the version and release specified by the VxRxMx value for the TGTRLS parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="INZBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>BRM13FF</b></dt>
|
||
|
|
<dd>Merge operation not successful. Reason &5
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1521</b></dt>
|
||
|
|
<dd>Connection to system &1 could not be established.
|
||
|
|
</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>BRM40A5</b></dt>
|
||
|
|
<dd>BRMS product initialization ended abnormally.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM40A6</b></dt>
|
||
|
|
<dd>BRMS product initialization already started.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM412B</b></dt>
|
||
|
|
<dd>Values not valid for parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM6708</b></dt>
|
||
|
|
<dd>Command ended due to error.
|
||
|
|
</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="#INZBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|