Increase the size of secondary allocation (SEC_INC)

The SEC_INC function helps avoid abends that can occur due to insufficient secondary allocations. The function helps prevent x37 abends for data sets that unexpectedly increase in size or that do so at infrequent intervals, by increasing the size of each successive secondary allocation at a specified point.

The SEC_INC keyword specifies whether to increase secondary allocations after a specific extent number is reached as defined by the SEC_INC_XTNT keyword.

Note: The SEC_INC function will not work with PDSEs. Advanced Allocation Management secondary allocation functions are not compatible with PDSEs.

Syntax

Read syntax diagramSkip visual syntax diagramSEC_INC=DISABLEENABLE

SEC_INC=ENABLE|DISABLE

Operands

ENABLE
Increase secondary allocations.
DISABLE
Do not increase secondary allocations.

Default

DISABLE

Environments

EXTEND

Usage and processing considerations

  • The SEC_INC keyword is associated with the SEC_INC_AMT keyword. You must set SEC_INC_AMT to a nonzero value to implement this function.
  • If the newly increased size does not fit in a single extent, you can reduce the size by also specifying the SEC_BEST function, or recover from it failing by using the SEC_REDUCE function.
  • The SEC_INC function supports only non-VSAM data sets.
The following is the processing order of the SEC_* functions:
  1. SEC_ALLOC
  2. SEC_INC
  3. SEC_BEST
  4. SEC_REDUCE

Related keywords

SEC_INC_AMT, SEC_INC_VOLNO, and SEC_INC_XTNT.

Example: SEC_INC=DISABLE

In the following example, SEC_INC is set to DISABLE; therefore, Advanced Allocation Management does not increase secondary allocations:

SEC_INC=DISABLE

Example: SEC_INC=ENABLE

In the following example, SEC_INC=ENABLE enables the SEC_INC function:

 * RULE DEFINITIONS                  
 DEFAULTS  SEC_INC=ENABLE          * Default settings 
           SEC_INC_AMT=100  
           SEC_INC_XTNT=1  
 *                                   
 INCLUDE  JOBNAME=ABCDJOB          * Item to include in processing

Note the following items:

  • SEC_INC_AMT=100 specifies, as a percentage of the previous allocation amount, the amount by which secondary allocations are to be increased. Because SEC_INC_AMT is set to 100, Advanced Allocation Management increases secondary allocations by 100 percent of the previous allocation amount.
  • SEC_INC_XTNT=1 specifies the extent number at which secondary allocations are to be increased as defined by the SEC_INC and SEC_INC_AMT keywords.

The INCLUDE keyword that follows the SEC_INC keywords specify the selection criteria. JOBNAME=ABCDJOB specifies that only jobs that have a job name of ABCDJOB are to be included in Advanced Allocation Management processing.

Therefore, if Advanced Allocation Management encounters a situation where the specified extent (extent 1) is reached for a job that has a job name of ABCDJOB, it increases the secondary allocations by 100 percent of the previous allocation amount, at extent 1.

A job that has a job name that does not match the job name selection criteria of ABCDJOB is allowed to abend if there is an insufficient secondary allocation.