173 lines
7.1 KiB
HTML
173 lines
7.1 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 Disk Reorganization (STRDSKRGZ)</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="STRDSKRGZ.Top_Of_Page"></a>
|
|
<h2>Start Disk Reorganization (STRDSKRGZ)</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="#STRDSKRGZ.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRDSKRGZ.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRDSKRGZ.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRDSKRGZ"></a>
|
|
<p>The Start Disk Reorganization (STRDSKRGZ) command allows the user to start the disk reorganization function for one or more auxiliary storage pools (ASPs). The user specifies a time limit that the function is to run for each ASP being reorganized. A message will be sent to the system history (QHST) log when the reorganization function is started for each ASP.
|
|
</p>
|
|
<p>Unused space will be collected together within the ASP. This allows future large disk allocations to be done more efficiently.
|
|
</p>
|
|
<p><b>Restriction:</b> You must have *ALLOBJ special authority to use this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRDSKRGZ.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="#STRDSKRGZ.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 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRDSKRGZ.ASPDEV"><b>ASPDEV</b></a></td>
|
|
<td valign="top">ASP device</td>
|
|
<td valign="top">Values (up to 32 repetitions): <i>Name</i>, *ALLAVL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRDSKRGZ.TIMLMT"><b>TIMLMT</b></a></td>
|
|
<td valign="top">Time limit</td>
|
|
<td valign="top">1-9999, *NOMAX</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRDSKRGZ.ASP"></a>
|
|
<h3>Auxiliary storage pool ID (ASP)</h3>
|
|
<p>Specifies for which auxiliary storage pools the disk reorganization function is to be started.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Disk reorganization will be started for the system ASP (ASP number 1) and all basic ASPs (ASP numbers 2-32) defined to the system.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-number</i></b></dt>
|
|
<dd>Specify the ASP for which disk reorganization is to be started. Valid ASP numbers are 1 to 32. Up to 32 ASP numbers may be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDSKRGZ.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the name of the auxiliary storage pool (ASP) device for which the disk reorganization is to be started. A value must be specified for the ASP parameter or the ASPDEV parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLAVL</b></dt>
|
|
<dd>Disk reorganization will be started for all ASP devices that currently have a status of 'Available'.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-device-name</i></b></dt>
|
|
<dd>Specify the name of the independent ASP device for which disk reorganization is to be started. Up to 32 ASP device names may be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDSKRGZ.TIMLMT"></a>
|
|
<h3>Time limit (TIMLMT)</h3>
|
|
<p>Specifies the amount of time, in minutes, that the reorganization function is allowed to run. When the time limit is reached the function ends. The time limit specified is for each ASP being reorganized. For example, if ASP(*ALL) is specified and the machine has four ASP's configured and TIMLMT(60) is specified, four reorganization functions are started and each can run 60 minutes. If reorganization of any ASP has not completed after 60 minutes, it will be forced to end. This allows you to do disk reorganization incrementally.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>There is no time limit for the reorganization function. For a large ASP that has many small unused disk areas, the reorganization function can take a long time to complete. If you start the reorganization function with *NOMAX and you want to force the function to end, you can use the End Disk Reorganization (ENDDSKRGZ) command.
|
|
</dd>
|
|
<dt><b><i>time-limit</i></b></dt>
|
|
<dd>Specify the time limit that the reorganization function is allowed to run. Valid values range from 1 to 9999 minutes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRDSKRGZ.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Starting Disk Reorganization for ASP 1</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRDSKRGZ ASP(1) TIMLMT(*NOMAX)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to start the disk reorganization function for ASP 1. The reorganization function will run until the ASP has been reorganized or it is ended through the ENDDSKRGZ command.
|
|
</p>
|
|
<p><b>Example 2: Starting Disk Reorganization with a Time Limit</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRDSKRGZ ASP(*ALL) TIMLMT(60)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to start the disk reorganization function for each ASP on the system. Each reorganization function will have a time limit of sixty minutes. After sixty minutes, any reorganization functions which have not completed will be ended.
|
|
</p>
|
|
<p><b>Example 3: Starting Disk Reorganization for an ASP Device</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRDSKRGZ ASPDEV(MYASP1) TIMLMT(*NOMAX)
|
|
</pre>
|
|
</p>
|
|
<p>This command allows the user to start the disk reorganization function for ASP device MYASP1. The reorganization function will run until the ASP has been reorganized or it is ended through the ENDDSKRGZ command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRDSKRGZ.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1888</b></dt>
|
|
<dd>Disk reorganization for ASP &1 already started.
|
|
</dd>
|
|
<dt><b>CPF1890</b></dt>
|
|
<dd>*ALLOBJ authority required for requested operation.
|
|
</dd>
|
|
<dt><b>CPF1891</b></dt>
|
|
<dd>Disk reorganization cannot be started on an ASP with only one unit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDSKRGZ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|