PRIM_REDUCE_INC

The PRIM_REDUCE_INC keyword specifies the increment to use (a percentage value of the current allocation amount) when reducing the primary allocation as enabled by the PRIM_REDUCE keyword.

Syntax

Read syntax diagramSkip visual syntax diagramPRIM_REDUCE_INC=xx,yy

PRIM_REDUCE_INC=xx,yy

Where:

xx
is the increment (0 - 99) to apply to the primary allocation on the first volume.
yy
is the increment (0 - 99) to apply to the primary allocation on the second and subsequent volumes.
Note: Specifying 0 disables PRIM_REDUCE.

Usage and processing considerations

When an out-of-space condition occurs for a primary allocation, the original allocation is reduced by the amount that is specified by PRIM_REDUCE_INC, up to the value specified for the PRIM_REDUCE_LIM keyword, until the allocation is successful.

For example, if enabled by the PRIM_REDUCE keyword, when an out-of-space condition occurs for a primary allocation on the first volume, Advanced Allocation Management reduces the original allocation by the amount that is specified by PRIM_REDUCE_INC until the allocation is successful or the limit that is specified by the PRIM_REDUCE_LIM keyword is reached.

For example, if PRIM_REDUCE_INC=5 and PRIM_REDUCE_LIM=80 Advanced Allocation Management reduces the allocation amount in 5 percent increments, not to exceed 80 percent of the original allocation amount.

Primary allocation on the first volume. PRIM_REDUCE_INC=5 indicates that the allocation amount is reduced in 5% increments. PRIM_REDUCE_LIM=80 indicates that the amount will not be reduced below 80% of the original allocation amount.
Figure 1. PRIM_REDUCE_INC (primary allocation on the first volume)
Note: The PRIM_REDUCE_INC keyword is associated with the PRIM_REDUCE and PRIM_REDUCE_LIM keywords. You must specify PRIM_REDUCE=ENABLE to implement this function and PRIM_REDUCE_LIM to specify the reduction limit.

Default

The default is 0,0.

Environments

ALLOCATE and EXTEND.

Related keywords

PRIM_REDUCE and PRIM_REDUCE_LIM.

Example

In the following example, when an out-of-space condition occurs for a primary allocation on the first volume, the original allocation is reduced by 40 percent of the current allocation amount, up to the value that is specified for the PRIM_REDUCE_LIM keyword, until the allocation is successful:

PRIM_REDUCE_INC=(40,40)

When an out-of-space condition occurs for a primary allocation on the second and subsequent volumes, the original allocation is also reduced by 40 percent of the current allocation amount, up to the value that is specified for the PRIM_REDUCE_LIM keyword, until the allocation is successful.