| 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 (being used by a subsystem, by an active job, or for data) 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, *DATA | 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 and the Backup and Recovery topics in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
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. Pools with *DATA activity level are not dynamically adjusted by the system.
| 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). Pools with *DATA activity level are not automatically adjusted by the system.
| 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). Pools with *DATA activity level are not automatically adjusted by the system.
| 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. Pools with *DATA activity level are not automatically adjusted by the system.
| 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. Pools with *DATA activity level are not automatically adjusted by the system.
| 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. Pools with *DATA activity level are not automatically adjusted by the system.
| 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. Pools with *DATA activity level are not automatically adjusted by the system.
| Top |
Example 1: Changing the Size of the Interactive Pool
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.
Example 2: Changing a Pool to Only be Used for Data
CHGSHRPOOL POOL(*SHRPOOL5) SIZE(80000)
ACTLVL(*DATA) TEXT('Data pool for LINUX1 NWSD')
This command changes Shared Pool 5 into a data pool with a size of 80000 kilobytes. The activity level will prevent any jobs from running in the pool.
| Top |
*ESCAPE Messages
| Top |