z/OS DFSMSrmm Implementation and Customization Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Making an ACS management class assignment

z/OS DFSMSrmm Implementation and Customization Guide
SC23-6874-00

To assign a management class, you must have the SMS subsystem active and have a valid SMS configuration.

You use the ACS routines to process the special calls that DFSMSrmm makes to the SMS subsystem for ACS processing. DFSMSrmm requests that the management class routine is run. The environment variable is set to RMMVRS so that you can differentiate allocation requests for system-managed data sets from requests by DFSMSrmm for a management class name. When DFSMSrmm calls the ACS routines with the &ACSENVIR variable set to either RMMPOOL or RMMVRS, the storage class (&STORCLAS variable) is set to the word USERMM.

The SMS read-only variables that are set for DFSMSrmm requests are:
  • &ACCT_JOB
  • &ACCT_STEP
  • &ACSENVIR
  • &DD
  • &DSN
  • &DSORG
  • &DSTYPE
  • &EXPDT
  • &FILENUM
  • &GROUP
  • &HLQ
  • &JOB
  • &LABEL
  • &LIBNAME
  • &LLQ
  • &NQUAL
  • &PGM
  • &STORGRP
  • &SYSNAME
  • &SYSPLEX
  • &UNIT
  • &USER
  • &XMODE
  1. For volumes managed by the VRSEL retention method, define vital record specifications for the management class names you plan to use as shown in Figure 1.
    Figure 1. Defining vital record specifications for non-system-managed volumes
     ...
    RMM ADDVRS DSNAME('CATALOG') WHILECATALOG
    RMM ADDVRS DSNAME('ONSITE') DAYS COUNT(31)
    RMM ADDVRS DSNAME('OFFSITE') CYCLES COUNT(5) LOCATION(STORE1) -
        NEXTVRS(DAYS90)
    RMM ADDVRS NAME(DAYS90) DAYS COUNT(90)
     ...
  2. You code your selection criteria and rules into the management class ACS routine as shown in Figure 2.
    Figure 2. Sample management class routine for managing non-system-managed volumes
    PROC 1 MGMTCLAS
     ...
     /***************************************************/
     /*   RMM POLICY FILTER LISTS                       */
     /***************************************************/
     ...
     FILTLIST POOLA INCLUDE(USERA.**,USERY.KEEP.*) -
                    EXCLUDE(USERA.POOLB.**)
     ...
      IF &ACSENVIR = 'RMMVRS' THEN
     /***************************************************/
     /*   RMM VRS ASSIGNMENT DECISIONS                  */
     /***************************************************/
       DO
         SELECT (&DSN)
           WHEN (&OFFSITE) SET &MGMTCLAS = 'OFFSITE'
           WHEN (&ONSITE)  SET &MGMTCLAS = 'ONSITE'
         END
         /* CATCH EXPDT=99000                           */
         IF &EXPDT = '1999000' THEN SET &MGMTCLAS = 'CATALOG'
     ...
       END
     ...
    END

If ACS processing does not set the management class name, DFSMSrmm processing continues without using management class names.

When your ACS routine sets a management class, no call is made to the EDG_EXIT100 installation exit to obtain a vital record specification management value. However, EDG_EXIT100 is still called to update the DFSMSrmm copy of the JFCB expiration date if necessary.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014