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

132 lines
6.2 KiB
HTML
Raw Permalink 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>Analyze Libraries using BRM (ANZLIBBRM)</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="ANZLIBBRM.Top_Of_Page"></a>
<h2>Analyze Libraries using BRM (ANZLIBBRM)</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="#ANZLIBBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ANZLIBBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ANZLIBBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ANZLIBBRM"></a>
<p>The Analyze Libraries using BRM (ANZLIBBRM) command prints an analysis of libraries that you have backed up as well as those that you did not back up. The size of the library and the number of objects is listed for each library.
</p>
<p>Before you can run the ANZLIBBRM command you must have first run the Retrieve Disk Information (RTVDSKINF) command. The RTVDSKINF command creates the files required by ANZLIBBRM to analyze your libraries.
</p>
<p>You can run the RTVDSKINF command by using <b>Option 1 = Retrieve disk space information </b> from the BRMS Backup Analysis panel (GO BRMBKUANL). If you have auxiliary storage pool devices on the system, you will need to run the RTVDSKINF command multiple times, once for each auxiliary storage pool device.
</p>
<p>
<b>Note: </b>The RTVDSKINF command requires you to be enrolled in system distribution directory. Use the Work with Directory Entries (WRKDIRE) command to create a distribution directory entry.
</p>
<p>You only need run the ANZLIBBRM command once after the RTVDSKINF jobs have completed. The RTVDSKINF commands are submitted to the QBATCH job queue using a job name of RTVDSKINF. Monitor for the completion of all RTVDSKINF jobs in the QBATCH subsystem before running the ANZLIBBRM command.
</p>
<p>The report produced by the ANZLIBRBM command is the Library Backup Analysis report. There will be multiple reports if you run the RTVDSKINF command for auxiliary storage pool devices in addition to the basic system report. The reports are written to printer file QP1ALA for the system and basic user auxiliary storage pools, and to printer file QP1ALAnnnnn for auxiliary storage pool devices, where nnnnn is the ASP identifier.
</p>
<p>There are no parameters for this command.
</p>
<p>The command uses the first device listed in the System Policy to determine the <b>Transfer rate </b>entry shown on the report. The transfer rate defaults to the device transfer rate as reported by the operating system. The transfer rate for a device can be changed using the <b>Work with Devices using BRM (WRKDEVBRM) </b>command, selecting option <b>2=Change </b>from the <b>Work with Devices </b>panel, and changing the value of the <b>Transfer rate per second </b>prompt on the <b>Change Tape Device </b>display.
</p>
<p>If BRMS cannot find the device specified in the System Policy, the transfer rate used in the report will be zero, the estimated times on the report will also be zero, and the following message will be printed at the bottom of the report.
</p>
<p>
<pre>
Error: Device information entries do not exist or
default device not specified in the System Policy.
</pre>
</p>
<p>The command uses the Media Class listed in the System Policy to determine the <b>Media capacity </b>entry shown on the report. The media capacity defaults to a fixed value established by BRMS for that Media Class. The media capacity for a Media Class can be changed using the <b>Work with Classes using BRM (WRKCLSBRM) </b>command, selecting option <b>2=Change </b>from the <b>Work with Media Classes </b>panel, and changing the value of the <b>Media capacity </b>prompt on the <b>Change Media Class </b>display.
</p>
<p>If BRMS cannot find the Media Class specified in the System Policy, the Media capacity used in the report will be zero, the estimated volumes will also be zero, and the following message will be printed on the report.
</p>
<p>
<pre>
Error: Default media class has not been established or
is not specified in the System Policy.
</pre>
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZLIBBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ANZLIBBRM.PARAMETERS.TABLE">Parameters</a></h3>None<br>
<table width="100%">
<tr><td align="right"><a href="#ANZLIBBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<hr size="2" width="100%">
<div><h3><a name="ANZLIBBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Analyse the Base System</b>
</p>
<p>
<pre>
GO BRMBKUANL
1. Retrieve Disk Space Information
RTVDSKINF ASPDEV(*SYSBAS)
ANZLIBBRM
</pre>
</p>
<p>These commands retrieve the disk information for the system and basic user auxiliary storage pools. Analysis of the retrieved data generates report QP1ALA.
</p>
<p><b>Example 2: Analyse Auxiliary Storage Pool PRIMETIME</b>
</p>
<p>
<pre>
GO BRMBKUANL
1. Retrieve Disk Space Information
RTVDSKINF ASPDEV(PRIMETIME)
ANZLIBBRM
</pre>
</p>
<p>These commands retrieve the disk information for the auxiliary storage pool device which uses device description PRIMETIME and is configured as auxiliary storage pool 35. Analysis of the retrieved data generates report QP1ALA00035.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZLIBBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ANZLIBBRM.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>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="#ANZLIBBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>