VOL_ADD_UPG_VOL

Syntax

VOL_ADD_UPG_VOL=AUTO|ELIGIBLE|INELIGIBLE

Operands

Specify one of the following operands:

AUTO

When the VOL_ADD function searches for a candidate volume for a component that is allocated to a non-SMS VSAM cluster or a member of its upgrade set during VOL_ADD processing, it first attempts to locate a suitable candidate volume within the set of volumes that are defined by the VOL_ADD_VSER, VOL_ADD_UNIT, and VOL_ADD_VGRP keywords (it excludes volumes that are allocated to the base cluster or its upgrade set). If the VOL_ADD function cannot find a suitable volume within the set of volumes, it expands the set of eligible volumes to include all of the volumes that are allocated to the base cluster and its upgrade set.

ELIGIBLE

When VOL_ADD searches for a suitable candidate volume to extend a component of the base cluster or its upgrade set, all volumes that are allocated to the base cluster and upgrade set for a non-SMS VSAM cluster are eligible candidate volumes for VOL_ADD processing along with the volumes that are defined by the VOL_ADD_VSER, VOL_ADD_UNIT, and VOL_ADD_VGRP keywords.

INELIGIBLE

When VOL_ADD searches for a suitable candidate volume to extend a component of the base cluster or its upgrade set, all volumes that are allocated to the base cluster and upgrade set for a non-SMS VSAM cluster are considered ineligible as candidate volumes for VOL_ADD processing. Only those volumes that are defined by the VOL_ADD_VSER, VOL_ADD_UNIT, and VOL_ADD_VGRP keywords are considered to be eligible.

Default

AUTO

Environments

EXTEND

Usage and processing considerations

• The VOL_ADD_UPG_VOL keyword is associated with the VOL_ADD keyword. You must specify VOL_ADD=ENABLE to implement the VOL_ADD_UPG_VOL function.
• The VOL_ADD_UPG_VOL keyword does not apply to SMS data sets.
• When Advanced Allocation Management considers the volumes that are allocated to a component of a VSAM data set, it includes primary and candidate volumes regardless of whether data exists on the volumes.

  For example, consider a base cluster with its index and data components on volume VOL001. The base cluster has one alternate index that is associated with it in the upgrade set, with its index and data components on VOL002. Presume that the data component of the base cluster must extend to a new volume. Also presume that the volume group that is associated with the extend consists of the volumes VOL001, VOL002, and VOL003. If you set VOL_ADD_UPG_VOL to INELIGIBLE even if space is available on VOL002, only VOL003 is considered as a candidate for the extend because the data set exists on VOL001, and VOL002 is part of the set of volumes that are allocated to the base cluster and the upgrade set. If you set VOL_ADD_UPG_VOL to ELIGIBLE, VOL002 and VOL003 are considered as candidate volumes for the extend.

Related keywords

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