Limit the operation of a rule definition to specific environments (ENVIRONMENT)

Within Advanced Allocation Management, the term environment describes a particular phase in the processing of a data set during which Advanced Allocation Management can perform function and selection processing.

The ENVIRONMENT keyword limits the operation of a rule definition to one or more specific environments. You can specify the ENVIRONMENT keyword on DEFAULTS, INCLUDE, or EXCLUDE statements.

Syntax

Read syntax diagramSkip visual syntax diagramENVIRONMENT=(,ALLACSALLOCATECATCHECKEXTEND STOW UNALLOCATE)

ENVIRONMENT=(ACS, ALL, ALLOCATE, CATCHECK, EXTEND, STOW, UNALLOCATE)

Operands

ACS
The point in SMS processing directly following the assignment of one or more of the SMS constructs of Data Class, Storage Class, Management Class, or Storage Group.
ALL
All points where Advanced Allocation Management intercepts processing. Specifying ALL is the same as specifying all of the previous six options (ACS, ALLOCATE, CATCHECK, EXTEND, STOW, and UNALLOCATE).
ALLOCATE
The point in processing where a new data set is allocated (including VSAM and non-VSAM, SMS and non-SMS data sets).
CATCHECK
The point in allocation processing where the determination of the prior existence of a data set is made. For SMS data sets, this point is just before the allocation of a data set. For non-SMS data sets, this point can be just before the allocation of a data set (or at unallocation processing time during catalog disposition processing).
EXTEND
The point in processing where a new extent is added to a data set on the current volume or on a new volume (including volume addition).
STOW
The point in PDS processing when a new member is being added to a data set and the directory is being updated.
UNALLOCATE
The point in processing where a data set is unallocated.
Note: You can specify one or more of the specified options.

Usage and processing considerations

While not required, the ENVIRONMENT keyword can be helpful when you are specifying and converting to rule definitions.

Default

ALL

Environments

ACS, ALLOCATE, CATCHECK, EXTEND, STOW, and UNALLOCATE.

Example

In the following example, the specified environment is EXTEND:

ENVIRONMENT=(EXT)