What's new in Advanced Allocation Management

This topic summarizes the technical changes for this edition.

New and changed information is indicated by a vertical bar (|) to the left of a change. Editorial changes that have no technical significance are not noted.

SC23-9817-07 for PTF UO02649

Added GLO1119E to Subsytem and Started Task Messages topic in Appendix D, Messages. For more information about GLO1119E message, see GLO1119E.

SC23-9817-07 for PTF UO02281

Added a new subsystem option D1_INTERCEPT. Before you start Advanced Allocation Management, D1_INTERCEPT should be set to enable or disable initialization of the D1 (IGGPRE00_EXIT) intercept. For more information about the option, see Specifying subsystem options.
Added following function keywords:
- FORCE_EOV - Enable the FORCE_EOV keyword to set the end of volume condition on the current volume and extend the data set to a new volume. For more information about FORCE_EOV keyword, see Force end of volume condition on the current volume (FORCE_EOV).
- FORCE_EOV_STORGRP - When an extend to a new volume occurs, you can select the new volume from the extended storage group specified with FORCE_EOV_STORGRP keyword. For more information about FORCE_EOV_STORGRP keyword, see FORCE_EOV_STORGRP.
Added following selection criteria keywords:
- CUR_VOLNO - CUR_VOLNO selection keyword specifies the volume sequence number. For more information about CUR_VOLNO keyword, see CUR_VOLNO.
- CUR_XTNT - CUR_XTNT selection keyword specifies the extent number on the volume. For more information about CUR_XTNT keyword, see CUR_XTNT.
Added FORCE_EOV, FORCE_EOV_STORGRP, CUR_VOLNO, and CUR_XTNT functions and messages to Activity descriptions and related functions and messages table. For more information about Activity Description, see ACTIVITY descriptions.
Added FORCE_EOV, FORCE_EOV_STORGRP, CUR_VOLNO, and CUR_XTNT keywords to the Function and Selection Criteria Environment Compatibility table. For more information about keywords, see Function and selection criteria environment compatibility.
Added GLO2097I and GLO2098I to Function Messages (non-VSAM, EAM, and JCL-allocated VSAM) topic in Appendix D, Messages. For more information about GLO2097I and GLO2098I messages, see GLO2097I and GLO2098I.

SC23-9817-07

Updated the DSORG syntax diagram to add IAM keywords. For more information, see DSORG.
Added a new subsytem option RLS_INTERCEPT.
For more information about the option, see Specifying subsystem options.

For more information about subsystem options modification and display reference and updated S1_INTERCEPT values, see Subsystem options modification and display reference.
Updated the SHUTDOWN CLEANUP operator command. For more information, see Migration requirements.
Added the Shutdown command to the Operator commands. You can use the shutdown command to stop the Advanced Allocation Management System and optionally perform cleanup of intercepts. For more information, see Shutdown commands.
Added following function keywords
- Added the SEC_INC_CLOSE_RESET keyword that you can use to specify whether to reset the allocation amount to the original quantity at data set close. For more information, see SEC_INC_CLOSE_RESET.
- Added the SEC_INC_LINEAR keyword that you can use to set the secondary allocations in linear mode instead of exponentially. For more information, see SEC_INC_LINEAR.
- Added the BEGIN-END Rule definition processing keyword that you can use to perform applicable actions for a matched rule definition and then move to the nested Rule definition for additional matching. For more information, see BEGIN-END Rule definition processing.
- Added the SET_VAR01 to SET_VAR09 keyword that you can use to define User variables. For more information, see SET_VAR01 to SET_VAR09.
Added following keywords in Enhanced allocation management functions:
- Added the SET_GDG_EMPTY keyword. For more information, see SET_GDG_EMPTY.
- Added the SET_GDG_EXTENDED keyword. For more information, see SET_GDG_EXTENDED.
- Added the SET_GDG_LIMIT keyword. For more information, see SET_GDG_LIMIT.
- Added the SET_GDG_ORDER keyword. For more information, see SET_GDG_ORDER.
- Added the SET_GDG_PURGE keyword. For more information, see SET_GDG_PURGE.
- Added the SET_GDG_SCRATCH keyword. For more information, see SET_GDG_SCRATCH.
- Added the SDISP_MOD keyword. For more information, see SDISP_MOD.
Added following selection criteria keywords:
- Added the GDG_EMPTY selection criteria keyword. For more information, see GDG_EMPTY.
- Added the GDG_EXTENDED selection criteria keyword. For more information, see GDG_EXTENDED.
- Added the GDG_LIMIT selection criteria keyword. For more information, see GDG_LIMIT.
- Added the GDG_ORDER selection criteria keyword. For more information, see GDG_ORDER.
- Added the GDG_PURGE selection criteria keyword. For more information, see GDG_PURGE.
- Added the GDG_SCRATCH selection criteria keyword. For more information, see GDG_SCRATCH.
- Added the Environment detection (ENV_SELECTION) selection criteria keyword that you can use to perform function and selection processing. For more information, see Environment detection (ENV_SELECTION).
- Added the VAR01 to VAR09 keyword that you can use to define User variables. For more information, see VAR01 to VAR09.
Added GLO1081E, GLO1281I, GLO1282E, GLO1283W, GLO1610I, GLO1611I, GLO1612I, GLO1613E, GLO1614E, GLO1620E, GLO1621E, GLO1622E, GLO1623E, GLO1624E, GLO1625E, GLO1626E, GLO1627E, GLO1628E, GLO1650I, GLO1670E, GLO1671E, GLO1672E, GLO1673E, GLO1674E, GLO1675E, GLO1676E, GLO1680E, GLO1681E, GLO1682I, GLO1683I and GLO1685E to Subsystem and started task messages. For more information, see Subsystem and started task messages.
Added GLO2140I to Function messages (non-VSAM, EAM, and JCL-allocated VSAM). For more information, see Function messages (non-VSAM, EAM, and JCL-allocated VSAM).
Updated GLO3195E and added GLO3192I, GLO3193I, GLO3196W, GLO3197I, and GLO3198I to Function messages (VSAM). For more information, see Function messages (VSAM).
Added GLO4041E, GLO4042E, GLO4044E, GLO4045E, GLO4046E, GLO4047E, and GLO4133E to Syntax-check messages. For more information, see Syntax-check messages.

SC23-9817-06

The PRIM_REDUCE_ALGORITHM keyword was added. For more information, see PRIM_REDUCE_ALGORITHM.
Message GLO1086W was added and messages GLO1086E, GLO1098E, and GLO1065E were removed.
For VSAM data sets accessed in RLS mode, Advanced Allocation Management can detect the dynamic addition of a new volume in conjunction with the VOL_ADD function on the current or other system images. For more information, see VSAM support.
Information regarding following messages have been added:
- GLO1250E, GLO1253E, GLO1255E, GLO1257E, GLO1260E, GLO1343E, GLO1344E, GLO1346E, GLO1347E, GLO1349E, GLO1350E, GLO1353E, GLO1356E, GLO1357E, GLO1359E, GLO1377E, GLO1392E, GLO2050E, GLO2052E, GLO2053E, GLO2055E, GLO2093E, GLO2094E, GLO2095E, GLO2096E, and GLO3129I.

SC23-9817-05

Information about Advanced Allocation Management and PDS/Es was clarified. For more information, see Features and benefits.
Information about sharing rule definitions was added. For more information, see Sharing rule definitions between instances.
Information about Advanced Allocation Management Extended Address Volume support and z/OS 1.11 and z/OS 1.12 was added. For more information, see Features and benefits.
The following keyword descriptions were updated: Bypass integrity check processing (BYPASS_CHECK), Dynamically add volumes (VOL_ADD), VOL_ADD_UNIT, VOL_ADD_VGRP, and VOL_ADD_VSER.
The ERASE and SET_ERASE keywords were added. For more information, see ERASE and SET_ERASE.
The VOL_ADD_UPG_VOL keyword was added. VOL_ADD_UPG_VOL helps improve performance when accessing the components of a base cluster and its upgrade set by extending components outside of the set of volumes that are already allocated, therefore minimizing contention among components. For more information, see VOL_ADD_UPG_VOL.
The EATTR selection criteria keyword was added. The EATTR keyword specifies the assigned Extended Attribute value for the data set. z/OS uses the Extended Attribute value to assign eligibility for use of cylinder-managed space on an Extended Address Volume (EAV). In addition, the EATTR keyword of the Data Class is supported in the Data Class Override functionality of Advanced Allocation Management. For more information, see EATTR.
In support of the EATTR keyword, a new Enhanced Allocation Management function, SET_EATTR, was added. For more information, see SET_EATTR.
The AOMATCH DD statement identifies a matching Advanced Allocation Management rule definition at the job step level. For more information, see Identifying a rule definition match.
Output options were added to the Tivoli Advanced Allocation Management Control Member Management panel. For more information, see Syntax-checking control data set members.
The Work DS Prefix field was added to the Tivoli Advanced Allocation Management View Event History panel. For more information, see Generating event history reports from the ISPF interface.
The PERFORMANCE option description for the AVS_ALGORITHM and VOL_ADD_ALGORITHM keywords was updated. For more information, AVS_ALGORITHM and VOL_ADD_ALGORITHM.
Information about VSAM support was updated. For more information, see Features and benefits.
Information about Advanced Allocation Management processing and specific job names was added. For more information, see Job names and Advanced Allocation Management processing.
Messages GLO043E, GLO044E, and GLO3220W were added. For more information, see User interface messages.
Message GLO7003W was added and message GLO7603W was updated. For more information, see Event recording and reporting messages and SMF Reporting Utility messages.
Message GLO1108E was added. For more information, see Subsystem and started task messages.
The explanation for message GLO3139E was updated to add information for VSAM data sets. For more information, see Function messages (VSAM).
Messages GLO2128I and GLO3128I were updated to include the total volume count. For more information, see Function messages (non-VSAM, EAM, and JCL-allocated VSAM) and Function messages (VSAM).

SC23-9817-04

Information about coexistence with earlier versions was updated. For more information, see Coexistence with earlier versions.
Information about Advanced Allocation Management and SORTWK data sets was added. For more information, see Compatibility with other products.
Information about setting the Z1_INTERCEPT subsystem option was added to Configuring Advanced Allocation Management. For more information, see Specifying subsystem options.
The PRIM_REDUCE function description was updated to include information about the SMS Guaranteed Space attribute. Information was also added about PRIM_REDUCE and DSORG and RECORG. For more information, see Controlled reduction of primary space (PRIM_REDUCE).
A new BYPASS_CHECK function was added. Use BYPASS_CHECK to bypass integrity checks for multiple concurrent OPENs against a data set and multiple DDs for the same data set within a job step for VOLADD processing. For more information, see Bypass integrity check processing (BYPASS_CHECK).
The SMF Reporting Utility was added. The utility generates a Projected Savings Report that you can use to help you evaluate potential Advanced Allocation Management cost savings. See SMF Reporting Utility for details.
The PSPACE_MB JCL equivalent example was updated.
New messages GLO2147I, GLO2157I, GLO2158I, GLO3145I, GLO3147I, GLO3160I, and GLO3161I were added. For more information, see Function messages (non-VSAM, EAM, and JCL-allocated VSAM) and Function messages (VSAM).
New messages were added for the SMF Reporting Utility. For more information, see SMF Reporting Utility messages.
Information about how to gather diagnostic information was added to the Troubleshooting chapter. For more information, see Gathering diagnostic information.

SC23-9817-03

The ability to create user-defined variables was added. User-defined variables are defined in the variables definitions member (VARDEFS). The variables can be specified on the following rule definition keywords and the volume group definition keyword VOLUMES:
- VOLSER_FIRST
- VOLSER_CURRENT
- VOLSER_ANY
- UNIT_NAME
- USERID
- DATACLAS
- MGMTCLAS
- STORCLAS
- STORGRP
- DDNAME
- PROGRAM
- DSNAME
- DSNAME_QUALIFIER
- JOBNAME
- VOL_ADD_VGRP
- VOL_ADD_VSER
- VOL_ADD_UNIT
- AVS_VGRP
- AVS_VSER
- AVS_UNIT
For more information, see Creating user-defined variable definitions.
Information about migrating to Advanced Allocation Management was updated. For more information, see Migrating to Advanced Allocation Management.
The configuration steps were updated for user-defined variables. For more information, see Configuring Advanced Allocation Management.
Information about the control data set and control member management options was updated for user-defined variables. For more information, see Components.
Information about comparison operands was updated. For more information, see Comparison operands and user-defined variables and Comparison operands and lists.
Volume group definition syntax was updated. For more information, see Volume group definition syntax.
Information about subsystem options was updated. For more information, see Viewing and updating subsystem options and Specifying subsystem options.
Command descriptions were updated. For more information, see Display commands and Dynamic configuration commands.
New messages were added to support user-defined variables. For more information, see Subsystem and started task messages.
More examples were added to Creating rule definitions.

SC23-9817-02

Information about how Advanced Allocation Management handles IBM DB2® data sets was added. See Features and benefits for details.
The following selection criteria keywords were enhanced to support multiple operands:
- DATACLAS
- DDNAME
- DSNAME
- DSNAME_QUALIFIER
- DSORG
- JOBNAME
- MGMTCLAS
- STORCLAS
- STORGRP
- PROGRAM
- USERID
The following selection criteria keywords were enhanced to support comparison operators:
- DSORG (EQ or NE)
- VOLSER_ANY
- VOLSER_CURRENT
- VOLSER_FIRST
A new DSN_PATTERN_MATCHING subsystem option was added. For more information, see Specifying subsystem options and Data set name filtering.
The PQTY and SET_PQTY keyword descriptions were updated. For more information, see PQTY and SET_PQTY.
New messages, GLO041E, GLO2194I, GLO1376I, GLO1378E, GLO1123W, and GLO3194I were added. For more information, see User interface messages, Subsystem and started task messages, Function messages (non-VSAM, EAM, and JCL-allocated VSAM), and Function messages (VSAM).
The following rule definitions keywords were changed to specify a minimum value of 1:
- SET_NUMVOLS
- SET_NUMVOLS_DATA
- SET_NUMVOLS_INDEX
- SET_VOLCT
- NUMVOLS
- NUMVOLS_DATA
- NUMVOLS_INDEX
- VOLCT
For more information, see Enhanced Allocation Management functions and Selection criteria keywords.
Information about coexistence between Advanced Allocation Management V3.2 and earlier versions of Advanced Allocation Management or Allocation Optimizer, was added. For more information, see Coexistence with earlier versions.
Information about comparison operands was updated. For more information, see Comparison operands and lists.
Advanced Allocation Management must be installed on a system with z/OS 1.11 and later.

SC23-9817-01

The NOTCAT2_DYNAL keyword was added to allow selective enablement of processing of dynamically allocated data sets for the NOTCAT2 function. For more information, see NOTCAT2_DYNAL.
The NOTCAT2 function was updated. See Process NOT CATLGD 2 errors (NOTCAT2) for details.
Information about Advanced Allocation Management processing was added to the VOL_ADD function. For more information, see Dynamically add volumes (VOL_ADD).
The SPACE_RELEASE function description was clarified. For more information, see Recover unused disk space (SPACE_RELEASE).
The TERM_ALLOC function description was updated. For more information, see Terminate an allocation (TERM_ALLOC).
The MOUNT_USAGE function description was clarified. For more information, see MOUNT_USAGE.
The description of the PRIM_REDUCE function was updated. For more information, see Controlled reduction of primary space (PRIM_REDUCE).
Information was added to the following Enhanced Allocation Management function keyword descriptions:
- SET_DATACLAS
- SET_MGMTCLAS
- SET_STORCLAS
- SET_STORGRP
For more information, see Enhanced Allocation Management functions.
Information was added to the following selection criteria keyword descriptions:
- DEVICECLASS
- GUARSPACE
- MOUNT_USAGE
- RELEASESPACE
- UNIT_TYPE
For more information, see Selection criteria keywords.
Information was added to describe the processing order of the SEC_* functions. For more information, see Add a secondary allocation (SEC_ALLOC), Increase the size of secondary allocation (SEC_INC), Recover from secondary allocation space failures (SEC_REDUCE), and Reduce secondary allocation to largest available free extent (SEC_BEST).
Default information was added for the following function keywords:
- AVS_UNIT
- AVS_VGRP
- AVS_VSER
- NOTCAT2_QUALIFIER
- NOTCAT2_SUFFIX
- SPACE_RELEASE
- VOL_ADD_UNIT
- VOL_ADD_VGRP
- VOL_ADD_VSER
For more information, see Functions.
More examples were added to the MSG_LEVEL keyword description. For more information, see MSG_LEVEL.
More examples were added to the topic Wildcard characters.
The descriptions for the SEC_ALLOC and SEC_INC function keywords were clarified. For more information, see Add a secondary allocation (SEC_ALLOC) and Increase the size of secondary allocation (SEC_INC).
The descriptions for the VOLCT, SET_VOLCT, NUMVOLS, and SET_NUMVOLS keywords were updated. For more information, see Functions and Selection criteria keywords.
Message GLO2197E was added. See Function messages (non-VSAM, EAM, and JCL-allocated VSAM) for details.
The message number for message GLO2150I (GLO2150I VOLSER(S): VVVVVV) was changed to GLO2156I. Message number GLO3150I was changed to GLO3156I.

SC23-9817-00

As of version 3.1, IBM Tivoli Allocation Optimizer for z/OS was renamed to IBM Tivoli Advanced Allocation Management for z/OS.
Advanced Allocation Management must be installed on a system with z/OS 1.8 and later.
Selection criteria keywords were added and updated. For more information, see Selection criteria keywords.
Support for Enhanced Allocation Management was added. For more information, see Enhanced Allocation Management functions.
Advanced volume selection capabilities were added. For more information, see Advanced Volume Selection (AVS).
Information was added to the GLO1036E message. For more information, see Subsystem and started task messages.
The GLOJIVP1 member steps and example output were updated. For more information, see Verifying the installation and Table 1.