300 lines
14 KiB
HTML
300 lines
14 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>Start ASP Balance (STRASPBAL)</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="STRASPBAL.Top_Of_Page"></a>
|
|
<h2>Start ASP Balance (STRASPBAL)</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="#STRASPBAL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRASPBAL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRASPBAL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRASPBAL"></a>
|
|
<p>The Start ASP Balance (STRASPBAL) command allows the user to start the auxiliary storage pool (ASP) balancing function for one or more ASPs. Four types of ASP balancing can be started:
|
|
</p>
|
|
<ol>
|
|
<li><b>Capacity balancing</b> - The data on all the units within the ASP will be balanced so each unit has an equal percentage of used and unused space. This is useful when new units are added to an ASP. Instead of having several units with the majority of the data and several new ones with no data, the user can spread the data evenly across all the units.
|
|
</li>
|
|
<li><b>Usage balancing</b> - The 'low' use data on each 'low' utilized unit in the ASP is redistributed to balance future use of the arm utilization of each unit within the specified ASP. *USAGE balancing cannot be done until the trace controlled by the Trace ASP Balance (TRCASPBAL) command has collected usage statistics. The TRCASPBAL command starts the trace function that will identify the 'high' and 'low' use data on each unit. After the usage balance activity has run to completion, the trace information will be cleared. Usage balancing is useful when the ASP contains large capacity disk units.
|
|
</li>
|
|
<li><b>Hierarchical Storage Management (HSM) balancing</b> - The 'high' use and 'low' use data on each unit in the ASP is redistributed so that the 'high' use data resides on high performance units and the 'low' use data resides on low performance units. The ASP being balanced in this manner must contain the correct mixture of slow and fast units to perform this type of balance. This allows the 'low' use data on the high performance units to be moved to low performance units. Data that is 'high' use that resides on slow units will be moved to the fast disk units. HSM balancing cannot be done until the trace controlled by the Trace ASP Balance (TRCASPBAL) command has collected usage statistics. The TRCASPBAL command starts the trace function that will identify the 'high' and 'low' use data on each unit. After the HSM balance activity has run to completion, the trace information will be cleared. HSM balancing is useful when the ASP contains compressed disk units.
|
|
</li>
|
|
<li><b>Move data from units</b> - This option can be used to reduce the down time associated with removing a disk unit. A unit that is scheduled for removal can be marked to end allocations by specifying UNIT(unit-number) and TYPE(*ENDALC). This will keep new allocations away from this unit. For all units marked *ENDALC, specifying TYPE(*MOVDTA) will move data from the marked units to other units in the same ASP. To resume allocations for units marked *ENDALC, specify UNIT(unit-number) and TYPE(*RSMALC). New allocations will once again be allowed to this unit. The Check ASP Balance (CHKASPBAL) command can be used to determine which units are currently marked *ENDALC.
|
|
</li>
|
|
</ol>
|
|
<p>The user may specify a time limit that the function is to run for each ASP being balanced or the balance can be set to run to completion. If the balance function needs to be ended, use the End ASP Balance (ENDASPBAL) command. A message will be sent to the system history (QHST) log when the balancing function is started for each ASP. A message will also be sent to the QHST log when the balancing function completes or is ended.
|
|
</p>
|
|
<p>If the balance function is run for a few hours and then stopped, it will continue from where it left off when the balance function restarts. This allows the balancing to be run during off hours over a several day period.
|
|
</p>
|
|
<p>For more information about ASP balancing, see the Hierarchical Storage Management Use, SC41-5351.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have all object (*ALLOBJ) special authority to run this command.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRASPBAL.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="#STRASPBAL.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Balance type</td>
|
|
<td valign="top">*CAPACITY, *USAGE, *HSM, *MOVDTA, *ENDALC, *RSMALC</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRASPBAL.ASP"><b>ASP</b></a></td>
|
|
<td valign="top">ASP number</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 32 repetitions): 1-32</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRASPBAL.ASPDEV"><b>ASPDEV</b></a></td>
|
|
<td valign="top">ASP device</td>
|
|
<td valign="top">Single values: *ALLAVL<br>Other values (up to 32 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRASPBAL.UNIT"><b>UNIT</b></a></td>
|
|
<td valign="top">Storage unit</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Integer</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRASPBAL.TIMLMT"><b>TIMLMT</b></a></td>
|
|
<td valign="top">Time limit</td>
|
|
<td valign="top">1-9999, *NOMAX</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRASPBAL.TYPE"></a>
|
|
<h3>Balance type (TYPE)</h3>
|
|
<p>Specifies the type of auxiliary storage pool (ASP) balancing operation to be done.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must always be specified for this parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CAPACITY</b></dt>
|
|
<dd>The capacity balance function will be started for the specified ASP (ASP or ASPDEV parameter).
|
|
</dd>
|
|
<dt><b>*USAGE</b></dt>
|
|
<dd>The usage balance function will be started for the specified ASP (ASP or ASPDEV parameter) .
|
|
</dd>
|
|
<dt><b>*HSM</b></dt>
|
|
<dd>The hierarchical storage management balance function will be started for the specified ASP (ASP or ASPDEV parameter).
|
|
</dd>
|
|
<dt><b>*MOVDTA</b></dt>
|
|
<dd>Data will be moved off all units marked *ENDALC to other units in the same ASP. The Check ASP Balance (CHKASPBAL) command can be used to determine which units are marked *ENDALC.
|
|
</dd>
|
|
<dt><b>*ENDALC</b></dt>
|
|
<dd>New allocations will no longer go to the specific units (UNIT parameter). However, the system will use these units for new allocations to avoid 'Out of storage' conditions.
|
|
</dd>
|
|
<dt><b>*RSMALC</b></dt>
|
|
<dd>Resume allocations to the specified units (UNIT parameter). If the unit has a much lower percentage used than other units in the ASP, run the STRASPBAL command again specifying TYPE(*CAPACITY) for the ASP that contains the unit. This will keep new allocations balanced across the units in the ASP, instead of going mostly to this unit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRASPBAL.ASP"></a>
|
|
<h3>Auxiliary storage pool ID (ASP)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) for which the ASP balancing function is to be started.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for either the <b>ASP number (ASP)</b> parameter or the <b>ASP device (ASPDEV)</b> parameter if *CAPACITY, *USAGE, or *HSM is specified for the <b>Balance type (TYPE)</b> parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>ASP balancing will be started for the system ASP (ASP number 1) and all basic ASPs (ASP numbers 2-32) defined to the system.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 32 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-32</i></b></dt>
|
|
<dd>Specify the number of the ASP for which ASP balancing is to be started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRASPBAL.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the name of the auxiliary storage pool (ASP) device for which the ASP balancing is to be started.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for either the <b>ASP number (ASP)</b> parameter or the <b>ASP device (ASPDEV)</b> parameter if *CAPACITY, *USAGE, or *HSM is specified for the <b>Balance type (TYPE)</b> parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLAVL</b></dt>
|
|
<dd>ASP balancing will be started for all ASP devices that currently have a status of 'Available'.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 32 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the independent ASP device for which ASP balancing is to be started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRASPBAL.UNIT"></a>
|
|
<h3>Storage unit (UNIT)</h3>
|
|
<p>Specifies the unit number for which new allocations are to be ended (if *ENDALC is specified for the <b>Balance type (TYPE)</b> parameter) or for which new allocations are to resume (if *RSMALC is specified for the TYPE parameter). Specifying TYPE(*MOVDTA) will start moving data off the units marked *ENDALC.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for this parameter if *ENDALC or *RSMALC is specified for the TYPE parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specify the unit number for which new allocations are to either end (if *ENDALC is specified) or resume (if *RSMALC is specified). Up to 300 unit numbers may be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRASPBAL.TIMLMT"></a>
|
|
<h3>Time limit (TIMLMT)</h3>
|
|
<p>Specifies the amount of time, in minutes, that the ASP balancing function will be allowed to run. When the time limit is reached, the function will end. For example, if ASP(*ALL) is specified and the machine has four ASPs configured and TIMLMT(60) is specified, four balance functions are started and each can run 60 minutes. If the balancing of any ASP has not completed after 60 minutes, it will be forced to end. This allows you to do ASP balancing incrementally. The balance function will not run across an IPL.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for this parameter if *CAPACITY, *USAGE, *HSM, or *MOVDTA is specified for the <b>Balance type (TYPE)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>There is no time limit for the balance function. For a large ASP the balance function can take a long time to complete. If you start the balance function with *NOMAX and you want to force the function to end, you can use the End ASP Balance (ENDASPBAL) command.
|
|
</dd>
|
|
<dt><b><i>1-9999</i></b></dt>
|
|
<dd>Specify the number of minutes that the balance function will be allowed to run.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRASPBAL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Starting ASP Balancing for ASP 1</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRASPBAL ASP(1) TIMLMT(*NOMAX) TYPE(*CAPACITY)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the *CAPACITY ASP balance function for ASP 1. The balance function will run until the capacity for each of the units has been balanced.
|
|
</p>
|
|
<p><b>Example 2: Starting ASP Balancing with a Time Limit</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRASPBAL ASP(*ALL) TIMLMT(60) TYPE(*USAGE)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the *USAGE ASP balance function for the system ASP and each configured basic ASP for which the TRCASPBAL command has been run. Each balance function will have a time limit of sixty minutes. After sixty minutes, any balance functions which have not completed will be ended.
|
|
</p>
|
|
<p><b>Example 3: Starting ASP Balancing for an ASP Device</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRASPBAL ASPDEV(MYASP1) TIMLMT(*NOMAX) TYPE(*CAPACITY)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the *CAPACITY ASP balance function for the ASP device named MYASP1. The balance function will run until complete.
|
|
</p>
|
|
<p><b>Example 4: Preparing to Remove Units</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRASPBAL UNIT(11 12 13) TYPE(*ENDALC)
|
|
</pre>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRASPBAL TYPE(*MOVDTA)
|
|
</pre>
|
|
</p>
|
|
<p>The first command marks units 11, 12 and 13 to no longer receive new allocations. The second command begins to move data off the marked units. It is recommended that the *MOVDTA ASP balancing function be done during an off-peak time.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRASPBAL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF18AB</b></dt>
|
|
<dd>ASP balancing for ASP &1 already started.
|
|
</dd>
|
|
<dt><b>CPF18AE</b></dt>
|
|
<dd>ASP &1 does not contain trace data.
|
|
</dd>
|
|
<dt><b>CPF18B1</b></dt>
|
|
<dd>Trace function currently running for ASP &1.
|
|
</dd>
|
|
<dt><b>CPF18AD</b></dt>
|
|
<dd>ASP &1 must contain more than a single unit.
|
|
</dd>
|
|
<dt><b>CPF18AF</b></dt>
|
|
<dd>ASP &1 does not contain mixed unit types.
|
|
</dd>
|
|
<dt><b>CPF18B3</b></dt>
|
|
<dd>Balance type not valid for ASP &1.
|
|
</dd>
|
|
<dt><b>CPF1890</b></dt>
|
|
<dd>*ALLOBJ authority required for requested operation.
|
|
</dd>
|
|
<dt><b>CPF9829</b></dt>
|
|
<dd>Auxiliary storage pool &1 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|