409 lines
15 KiB
HTML
409 lines
15 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 Shared Storage Pool (CHGSHRPOOL)</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="CHGSHRPOOL.Top_Of_Page"></a>
|
|
<h2>Change Shared Storage Pool (CHGSHRPOOL)</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="#CHGSHRPOOL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGSHRPOOL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGSHRPOOL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGSHRPOOL"></a>
|
|
<p>The Change Shared Storage Pool (CHGSHRPOOL) command changes the size, activity level, or tuning values for a shared pool. The only authority required to change a shared pool is authority to the command. When increasing the size of the shared pool, the change takes effect immediately if the shared pool is active (in use by a subsystem or active job) and the storage is available. If the shared pool is not active, the change takes effect when a subsystem is started using the shared pool.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGSHRPOOL.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="#CHGSHRPOOL.POOL"><b>POOL</b></a></td>
|
|
<td valign="top">Pool identifier</td>
|
|
<td valign="top">*MACHINE, *BASE, *INTERACT, *SPOOL, *SHRPOOL1, *SHRPOOL2, *SHRPOOL3, *SHRPOOL4, *SHRPOOL5, *SHRPOOL6, *SHRPOOL7, *SHRPOOL8, *SHRPOOL9, *SHRPOOL10, *SHRPOOL11, *SHRPOOL12, *SHRPOOL13, *SHRPOOL14, *SHRPOOL15, *SHRPOOL16, *SHRPOOL17, *SHRPOOL18, *SHRPOOL19, *SHRPOOL20, *SHRPOOL21, *SHRPOOL22, *SHRPOOL23, *SHRPOOL24, *SHRPOOL25, *SHRPOOL26, *SHRPOOL27, *SHRPOOL28, *SHRPOOL29, *SHRPOOL30, *SHRPOOL31, *SHRPOOL32, *SHRPOOL33, *SHRPOOL34, *SHRPOOL35, *SHRPOOL36, *SHRPOOL37, *SHRPOOL38, *SHRPOOL39, *SHRPOOL40, *SHRPOOL41, *SHRPOOL42, *SHRPOOL43, *SHRPOOL44, *SHRPOOL45, *SHRPOOL46, *SHRPOOL47, *SHRPOOL48, *SHRPOOL49, *SHRPOOL50, *SHRPOOL51, *SHRPOOL52, *SHRPOOL53, *SHRPOOL54, *SHRPOOL55, *SHRPOOL56, *SHRPOOL57, *SHRPOOL58, *SHRPOOL59, *SHRPOOL60</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.SIZE"><b>SIZE</b></a></td>
|
|
<td valign="top">Storage size</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *NOSTG</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.ACTLVL"><b>ACTLVL</b></a></td>
|
|
<td valign="top">Activity level</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.PAGING"><b>PAGING</b></a></td>
|
|
<td valign="top">Paging option</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *FIXED, *CALC</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.MINFAULT"><b>MINFAULT</b></a></td>
|
|
<td valign="top">Minimum page faults</td>
|
|
<td valign="top"><i>Decimal number</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.JOBFAULT"><b>JOBFAULT</b></a></td>
|
|
<td valign="top">Per thread page faults</td>
|
|
<td valign="top"><i>Decimal number</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.MAXFAULT"><b>MAXFAULT</b></a></td>
|
|
<td valign="top">Maximum page faults</td>
|
|
<td valign="top"><i>Decimal number</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.PTY"><b>PTY</b></a></td>
|
|
<td valign="top">Priority</td>
|
|
<td valign="top">1-14, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.MINPCT"><b>MINPCT</b></a></td>
|
|
<td valign="top">Minimum size %</td>
|
|
<td valign="top">0.0-100.0, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSHRPOOL.MAXPCT"><b>MAXPCT</b></a></td>
|
|
<td valign="top">Maximum size %</td>
|
|
<td valign="top">0.0-100.0, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGSHRPOOL.POOL"></a>
|
|
<h3>Pool identifier (POOL)</h3>
|
|
<p>Specifies the shared pool being changed. More information about storage pools is in the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter or the Backup and Recovery book, SC41-5304.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*MACHINE</b></dt>
|
|
<dd>The machine pool used for Licensed Internal Code is changed. Only the size can be changed for the machine pool. This is the same as using the Change System Value (CHGSYSVAL) command to change the QMCHPOOL system value.
|
|
</dd>
|
|
<dt><b>*BASE</b></dt>
|
|
<dd>The base pool is changed. Only the activity level can be changed for the base pool. This is the same as using the CHGSYSVAL command to change the QBASACTLVL system value.
|
|
</dd>
|
|
<dt><b>*INTERACT</b></dt>
|
|
<dd>The shared pool for interactive work is changed.
|
|
</dd>
|
|
<dt><b>*SPOOL</b></dt>
|
|
<dd>The shared pool used for spooled writers is changed.
|
|
</dd>
|
|
<dt><b>*SHRPOOLnn</b></dt>
|
|
<dd>A general-purpose shared pool is changed. There are sixty general-purpose shared pools, identified by special values *SHRPOOL1 to *SHRPOOL60.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.SIZE"></a>
|
|
<h3>Storage size (SIZE)</h3>
|
|
<p>Specifies the size of the storage pool expressed in kilobyte (1KB = 1024 bytes) multiples. This is the amount of main storage that can be used by the pool. A value of at least 256 (256KB) must be specified for the storage size.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The size does not change.
|
|
</dd>
|
|
<dt><b>*NOSTG</b></dt>
|
|
<dd>No storage or activity level is defined for the pool. A pool cannot be changed to *NOSTG if it is being used by an active subsystem or active job or if the pool has reserved storage.
|
|
</dd>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specify the size in kilobytes of the storage pool.
|
|
<p>
|
|
<b>Note: </b>Changes to the size of a pool may require pages to be written to auxiliary storage. The time required for the system to complete a large change may be greater than your default wait time. If this occurs, message CPF1001 (Wait time expired for system response.) is issued, even though the change completes.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.ACTLVL"></a>
|
|
<h3>Activity level (ACTLVL)</h3>
|
|
<p>Specifies the maximum number of threads that can run at the same time in the pool.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The activity level does not change.
|
|
</dd>
|
|
<dt><b><i>integer</i></b></dt>
|
|
<dd>Specify the activity level for the pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.PAGING"></a>
|
|
<h3>Paging option (PAGING)</h3>
|
|
<p>Specifies the paging option associated with the pool. The paging option determines whether the system dynamically adjusts the paging characteristics for the storage pool for optimum performance.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*FIXED</b></dt>
|
|
<dd>The system default values are used. The system does not dynamically adjust the paging characteristics for the storage pool.
|
|
</dd>
|
|
<dt><b>*CALC</b></dt>
|
|
<dd>The system dynamically adjusts the paging characteristics for the storage pool to ensure optimum performance.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the shared pool.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.MINFAULT"></a>
|
|
<h3>Minimum page faults (MINFAULT)</h3>
|
|
<p>Specifies the minimum page faults per second to use as a guideline for this storage pool. This value is used by the system if the QPFRADJ system value is set to 2 or 3 (automatic adjustment).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The minimum faulting rate guideline is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>decimal-number</i></b></dt>
|
|
<dd>Specify the minimum page faults per second to use for the paging guideline for this pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.JOBFAULT"></a>
|
|
<h3>Per thread page faults (JOBFAULT)</h3>
|
|
<p>Specifies the page faults per second for each active thread to use as a guideline for this storage pool. Each job is comprised of one or more threads. A thread is counted as active when it uses CPU resource. This value is used by the system if the QPFRADJ system value is set to 2 or 3 (automatic adjustment).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The guideline for the page faults per second for each active thread is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>decimal-number</i></b></dt>
|
|
<dd>Specify the page faults per second for each active thread to use for the paging guideline for this pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.MAXFAULT"></a>
|
|
<h3>Maximum page faults (MAXFAULT)</h3>
|
|
<p>Specifies the maximum page faults per second to use as a guideline for this storage pool. This value is used by the system if the QPFRADJ system value is set to 2 or 3.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The maximum faulting rate guideline is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>decimal-number</i></b></dt>
|
|
<dd>Specify the maximum page faults per second to use for the paging guideline for this pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.PTY"></a>
|
|
<h3>Priority (PTY)</h3>
|
|
<p>Specifies the priority of this pool relative to the priority of the other storage pools. The valid range for priority is 1-14, where 1 is the highest priority and 14 is the lowest priority. This value is used by the system if the QPFRADJ system value is set to 2 or 3.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The storage pool priority is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>1-14</i></b></dt>
|
|
<dd>Specify the priority of the storage pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.MINPCT"></a>
|
|
<h3>Minimum size % (MINPCT)</h3>
|
|
<p>Specifies the minimum amount of storage to allocate to this storage pool (as a percentage of total main storage). This value is used by the system if the QPFRADJ system value is set to 2 or 3.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The minimum pool size is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>0.0-100.0</i></b></dt>
|
|
<dd>Specify a percentage of total main storage to use as a minimum size for this storage pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSHRPOOL.MAXPCT"></a>
|
|
<h3>Maximum size % (MAXPCT)</h3>
|
|
<p>Specifies the maximum amount of storage to allocate to this storage pool (as a percentage of total main storage). The maximum size of a pool is determined by this percentage and the amount of storage allocated to the other active pools. This value is used by the system if the QPFRADJ system value is set to 2 or 3.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The maximum pool size is set to the system default value for this pool.
|
|
</dd>
|
|
<dt><b><i>0.0-100.0</i></b></dt>
|
|
<dd>Specify a percentage of total main storage to use as a maximum size for this storage pool.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSHRPOOL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGSHRPOOL POOL(*INTERACT) SIZE(4200)
|
|
ACTLVL(*SAME) PAGING(*SAME)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the size of the interactive pool to 4200 kilobytes. The activity level and paging option remain the same.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSHRPOOL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1001</b></dt>
|
|
<dd>Wait time expired for system response.
|
|
</dd>
|
|
<dt><b>CPF1076</b></dt>
|
|
<dd>Specified value not allowed for system value &1.
|
|
</dd>
|
|
<dt><b>CPF1078</b></dt>
|
|
<dd>System value &1 not changed.
|
|
</dd>
|
|
<dt><b>CPF113A</b></dt>
|
|
<dd>Sum of MINFAULT and JOBFAULT parameters exceeds MAXFAULT parameter.
|
|
</dd>
|
|
<dt><b>CPF113B</b></dt>
|
|
<dd>Minimum size percentage exceeds maximum size percentage.
|
|
</dd>
|
|
<dt><b>CPF113C</b></dt>
|
|
<dd>Private pool attributes not changed.
|
|
</dd>
|
|
<dt><b>CPF1157</b></dt>
|
|
<dd>Shared pool &1 not changed to *NOSTG.
|
|
</dd>
|
|
<dt><b>CPF1165</b></dt>
|
|
<dd>Specified parameter not allowed for *MACHINE pool.
|
|
</dd>
|
|
<dt><b>CPF1166</b></dt>
|
|
<dd>Specified parameter not allowed for *BASE pool.
|
|
</dd>
|
|
<dt><b>CPF1167</b></dt>
|
|
<dd>ACTLVL not specified for pool &1.
|
|
</dd>
|
|
<dt><b>CPF1225</b></dt>
|
|
<dd>SIZE not specified for pool &1.
|
|
</dd>
|
|
<dt><b>CPF1831</b></dt>
|
|
<dd>User not authorized to change system value &1.
|
|
</dd>
|
|
<dt><b>CPF1864</b></dt>
|
|
<dd>User not authorized to change system value &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSHRPOOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|