253 lines
9.0 KiB
HTML
253 lines
9.0 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>Trace ASP Balance (TRCASPBAL)</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="TRCASPBAL.Top_Of_Page"></a>
|
|
<h2>Trace ASP Balance (TRCASPBAL)</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="#TRCASPBAL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#TRCASPBAL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#TRCASPBAL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="TRCASPBAL"></a>
|
|
<p>The Trace ASP Balance (TRCASPBAL) command controls the function that gathers the auxiliary storage pool (ASP) usage statistics. The trace function monitors the frequency that data is accessed on the disk units within the specified ASP. The 'high' use data and the 'low' use data on the units is identified. The tracing of the usage of data on the units can be started on a specific ASP or for multiple ASPs. The trace may be started for a specific length of time. The trace can be stopped by specifying *OFF for the <b>Trace option setting (SET)</b> parameter. The trace can be ended at any time and restarted at a later time. The statistics that are collected are cumulative. For example, if the trace is started and ended and then restarted without clearing the statistics, the second group of statistics are added to the first collection.
|
|
</p>
|
|
<p>After statistics have been collected the ASP may be balanced using the Start ASP Balance (STRASPBAL) command, specifying TYPE(*USAGE) or TYPE(*HSM). After the balance has run to completion, the statistics will be cleared automatically by the balance function.
|
|
</p>
|
|
<p>The balancing of the ASP should be done shortly after the statistics have been collected. The usefulness of the balance is diminished as the trace statistics age. If the statistics are not current, the statistics may be cleared by specifying *CLEAR for the SET parameter.
|
|
</p>
|
|
<p>A message will be sent to the system history (QHST) log when the trace function is turned on, when it is stopped, or the trace data is cleared.
|
|
</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="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="TRCASPBAL.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="#TRCASPBAL.SET"><b>SET</b></a></td>
|
|
<td valign="top">Trace option setting</td>
|
|
<td valign="top">*ON, *OFF, *CLEAR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCASPBAL.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="#TRCASPBAL.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, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCASPBAL.TIMLMT"><b>TIMLMT</b></a></td>
|
|
<td valign="top">Time limit</td>
|
|
<td valign="top">1-9999, *NOMAX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="TRCASPBAL.SET"></a>
|
|
<h3>Trace option setting (SET)</h3>
|
|
<p>Specifies whether to start collecting statistics, end the collection of statistics, or delete previously collected usage statistics for an auxiliary storage pool (ASP).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must always be specified for this parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ON</b></dt>
|
|
<dd>The tracing of the statistics will be started.
|
|
</dd>
|
|
<dt><b>*OFF</b></dt>
|
|
<dd>The tracing of the statistics will be ended.
|
|
</dd>
|
|
<dt><b>*CLEAR</b></dt>
|
|
<dd>The statistics for the specified ASP will be cleared.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCASPBAL.ASP"></a>
|
|
<h3>ASP number (ASP)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) for which the ASP tracing function will be started, ended, or cleared.
|
|
</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.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>ASP tracing will be started, ended, or cleared 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 tracing is to be started, ended, or cleared.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCASPBAL.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) device for which the tracing function will be started, ended, or cleared.
|
|
</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.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLAVL</b></dt>
|
|
<dd>ASP tracing will be started, ended, or cleared 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="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCASPBAL.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. The trace function will not run across an IPL.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A value must be specified for this parameter if *ON is specified for the <b>Trace option setting (SET)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-9999</i></b></dt>
|
|
<dd>Specify the number of minutes that the trace function will be allowed to run.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCASPBAL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Start Trace for ASP 1</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCASPBAL ASP(1) SET(*ON) TIMLMT(9999)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to start the ASP tracing function for ASP 1. This function will run until the user ends the trace or 9999 minutes have passed.
|
|
</p>
|
|
<p><b>Example 2: End Tracing for All ASPs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCASPBAL ASP(*ALL) SET(*OFF)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to end the ASP tracing function for each ASP that currently has a trace running.
|
|
</p>
|
|
<p><b>Example 3: Clear the Trace Data for ASP 1</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCASPBAL ASP(1) SET(*CLEAR)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to clear the trace data for ASP 1.
|
|
</p>
|
|
<p><b>Example 4: End Tracing for All ASP Devices</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCASPBAL ASPDEV(*ALLAVL) SET(*OFF)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to end the ASP tracing function for each ASP device that currently has a trace running.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCASPBAL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1890</b></dt>
|
|
<dd>*ALLOBJ authority required for requested operation.
|
|
</dd>
|
|
<dt><b>CPF18A9</b></dt>
|
|
<dd>ASP tracing for ASP &1 already started.
|
|
</dd>
|
|
<dt><b>CPF18AA</b></dt>
|
|
<dd>ASP tracing not active for ASP &1.
|
|
</dd>
|
|
<dt><b>CPF18AD</b></dt>
|
|
<dd>ASP &1 must contain more than a single unit.
|
|
</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>CPF18B2</b></dt>
|
|
<dd>Balance function running for ASP &1.
|
|
</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="#TRCASPBAL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|