VOL_ADD_ALGORITHM

The VOL_ADD_ALGORITHM keyword specifies a volume selection algorithm to use when extending to a new volume.

Syntax

Read syntax diagramSkip visual syntax diagramVOL_ADD_ALGORITHM=LARGESTSINGLEBESTFITFIRSTMOSTFREESPACEPERFORMANCE

VOL_ADD_ALGORITHM=BESTFIT|FIRST|LARGESTSINGLE|MOSTFREESPACE |PERFORMANCE

Operands

BESTFIT
Select the volume (or volumes) with a single extent in which the requested amount is closest to the requested primary allocation quantity (for VSAM data sets) or the secondary allocation quantity (for non-VSAM data sets) without being less than the requested primary allocation quantity or secondary allocation quantity, as appropriate.
FIRST
Select the first volume (or volumes) with enough total freespace to satisfy the requested allocation amount.
Note: The allocation amount might not be able to be satisfied because the freespace needed might be spread out across more than five extents, which is the normal limit within allocation for satisfying a space request. Therefore, you might need to specify PRIM_REDUCE to help make the allocation successful.
LARGESTSINGLE
Select the volume (or volumes) with the largest single free extent.
Note: Advanced Allocation Management selects a volume with the largest single extent. This does not mean that the volume has enough space to satisfy the requested amount, it simply indicates that it is the volume with the largest single extent. Therefore, you might need to use the PRIM_REDUCE function to handle those situations where the selected volume does not have adequate space available.
MOSTFREESPACE
Select the volume with the most available freespace. The most freespace is defined as the total number of free cylinders or tracks on the volume, depending upon the allocation unit that is used. If cylinder allocation is specified, the total number of free cylinders is considered. Otherwise, the total number of free tracks is considered.
PERFORMANCE
Select the volume with the lowest fragmentation index, giving preference to those volumes that have enough available freespace to satisfy the allocation request.

Default

LARGESTSINGLE

Environments

EXTEND

Related keywords

VOL_ADD, VOL_ADD_LIM, VOL_ADD_MOUNT_USAGE, VOL_ADD_PROMPT, VOL_ADD_SGRP, VOL_ADD_UNIT, VOL_ADD_VGRP, VOL_ADD_VGRP_SEARCH, VOL_ADD_UPG_VOL, and VOL_ADD_VSER.

Example

In the following example, the volume with most available freespace is selected:

VOL_ADD_ALGORITHM=MOSTFREESPACE