201 lines
7.4 KiB
HTML
201 lines
7.4 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>Change ASP Attribute (CHGASPA)</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="CHGASPA.Top_Of_Page"></a>
|
|
<h2>Change ASP Attribute (CHGASPA)</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="#CHGASPA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGASPA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGASPA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGASPA"></a>
|
|
<p>The Change Auxiliary Storage Pool Attributes (CHGASPA) command allows the user to change attributes that control the behavior of an auxiliary storage pool (ASP).
|
|
</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="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGASPA.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="#CHGASPA.ASP"><b>ASP</b></a></td>
|
|
<td valign="top">ASP number</td>
|
|
<td valign="top">Single values: *ALLUSR<br>Other values (up to 31 repetitions): 2-32</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGASPA.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="#CHGASPA.CPRRCYPCY"><b>CPRRCYPCY</b></a></td>
|
|
<td valign="top">Compression recovery policy</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *OVERFLOW, *RETRY, *WAIT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGASPA.ASP"></a>
|
|
<h3>ASP number (ASP)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) for which the ASP attributes are to be changed.
|
|
</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>*ALLUSR</b></dt>
|
|
<dd>The specified attributes will be changed for all basic ASPs (ASP numbers 2-32) defined. The system ASP (ASP number 1) will not be changed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 31 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>2-32</i></b></dt>
|
|
<dd>Specify the number of the basic ASP for which the specified attribute is to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGASPA.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the name of the auxiliary storage pool (ASP) device for which the attributes are to be changed.
|
|
</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>The specified attributes will be changed for all ASP devices that currently have a state 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 the specific attribute is to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGASPA.CPRRCYPCY"></a>
|
|
<h3>Compression recovery policy (CPRRCYPCY)</h3>
|
|
<p>Specifies what the compression recovery policy for the auxiliary storage pool (ASP) will be. This policy is how the system will handle ASP overflow situations when the ASP contains compressed units. See the Backup and Recovery book, SC41-5304 for more information about the compression recovery policy.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The compression recovery policy does not change.
|
|
</dd>
|
|
<dt><b>*OVERFLOW</b></dt>
|
|
<dd>When the system detects a condition where the ASP capacity is about to be exceeded, data will immediately overflow into the system ASP. The system default compression recovery policy is *OVERFLOW.
|
|
<p>
|
|
<b>Note: </b>This parameter value cannot be specified for ASP devices.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*RETRY</b></dt>
|
|
<dd>When the system detects a condition where the ASP capacity is about to be exceeded, the system posts system reference code (SRC) <b>A6xx 0277</b> in the system control panel and waits for space to become available in the ASP. Once space becomes available, the SRC is removed from the system control panel and normal operation will resume for that ASP.
|
|
<p>If space cannot be made available in the ASP and the ASP is a basic user ASP (ASP numbers 2-32), the SRC is removed from the system control panel, the data overflows into the system ASP (ASP number 1), and normal operation resumes. For an ASP device, the operation fails if space cannot be made available.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*WAIT</b></dt>
|
|
<dd>When the system detects a condition where the ASP capacity is about to be exceeded, the system posts an SRC <b>A6xx 0277</b> in the system control panel and will wait indefinitely for space to become available. Normal operations against this ASP will not resume until the user takes action. Some possible actions that the user could take will include changing the compression recovery policy to allow the ASP to overflow or deleting objects in the ASP.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGASPA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Change All User ASPs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGASPA ASP(*ALLUSR) CPRRCYPCY(*WAIT)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the compression recovery policy for all user auxiliary storage pools to *WAIT.
|
|
</p>
|
|
<p><b>Example 2: Change Specific ASPs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGASPA ASP(2 5) CPRRCYPCY(*RETRY)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the compression recovery policy for auxiliary storage pools 2 and 5 to *RETRY.
|
|
</p>
|
|
<p><b>Example 3: Change Specific ASP Devices</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGASPA ASPDEV(MYASP1) CPRRCYPCY(*RETRY)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the compression recovery policy for auxiliary storage pool ASP device MYASP1.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGASPA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9829</b></dt>
|
|
<dd>Auxiliary storage pool &1 not found.
|
|
</dd>
|
|
<dt><b>CPF1890</b></dt>
|
|
<dd>*ALLOBJ authority required for requested operation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGASPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|