| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| POOL | Pool identifier | *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 | Required, Positional 1 |
| SIZE | Storage size | Integer, *SAME, *NOSTG | Optional, Positional 2 |
| ACTLVL | Activity level | Integer, *SAME | Optional, Positional 3 |
| PAGING | Paging option | *SAME, *FIXED, *CALC | Optional, Positional 4 |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| MINFAULT | Minimum page faults | Decimal number, *SAME, *DFT | Optional |
| JOBFAULT | Per thread page faults | Decimal number, *SAME, *DFT | Optional |
| MAXFAULT | Maximum page faults | Decimal number, *SAME, *DFT | Optional |
| PTY | Priority | 1-14, *SAME, *DFT | Optional |
| MINPCT | Minimum size % | 0.0-100.0, *SAME, *DFT | Optional |
| MAXPCT | Maximum size % | 0.0-100.0, *SAME, *DFT | Optional |
| Top |
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.
This is a required parameter.
| Top |
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.
Note: 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.
| Top |
Specifies the maximum number of threads that can run at the same time in the pool.
| Top |
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.
| Top |
Specifies the text that briefly describes the shared pool.
| Top |
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).
| Top |
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).
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
CHGSHRPOOL POOL(*INTERACT) SIZE(4200)
ACTLVL(*SAME) PAGING(*SAME)
This command changes the size of the interactive pool to 4200 kilobytes. The activity level and paging option remain the same.
| Top |
*ESCAPE Messages
| Top |