Control-M/Tape DFSMS Interface

This chapter includes the following topics:

DFSMS SupportLink copied to clipboard

The Control-M/Tape to DFSMS Interface enables you to:

  • determine the expiration date of a data set on a tape according to DFSMS Management Class definitions

  • use Management Class as a selection parameter in rule definitions (see ON MGMTCLAS in the rule parameters chapter of the Control-M/Tape User Guide)

Implementation of the Control-M/Tape to DFSMS interface consists of:

  • Storage and Management class definition in DFSMS.

  • adjusting ACS Routines

  • activation of the interface in Control-M/Tape

Management Classes and Storage ClassesLink copied to clipboard

Management Classes - In order to enable Control-M/Tape to identify DFSMS-managed tape data sets, Management classes must be defined for all these data sets. These management classes can be used as part of the selection criteria that trigger a Control-M/Tape rule.

The following management class attributes are referenced by Control-M/Tape to determine the retention for a DFSMS-managed data set:

  • Expiration attributes (Expire After Days Non-Usage, Expire After Date or Days)

  • Retention Limit

  • # GDG Elements On Primary

For more information regarding the Control-M/Tape handling of DFSMS Management classes, see the description in the organization and administration chapter of the Control-M/Tape User Guide.

Storage Classes - Ensure that each DFSMS-managed tape to be handled by Control-M/Tape is assigned a DFSMS Storage class. DFSMS activates the Management Class ACS routine only if a Storage Class is assigned to the data set.

Activating Control-M/Tape Support for DFSMSLink copied to clipboard

To activate the DFSMS interface of Control-M/Tape, perform the following steps:

  1. Edit the CTTPARM member in the IOA PARM library:

    1. Specify Y for the SMSINTR parameter.

    2. Review the description of the OVERJCL installation parameter, and determine if its value should be changed.

    3. Save this member.

  2. If Control-M/Tape is active, refresh the installation parameters in memory. To do this, issue the following operator command:

    CopyCopied to clipboard 
    SCTTINIT,PARM='MODE=RELOAD,TBLT=PARM'

    If Control-M/Tape is not active, changes to the Control-M/Tape installation parameters are automatically loaded the next time Control-M/Tape is started.

    Optionally, you can define rules that use Management Class as a selection criteria (meaning, ON MGMTCLAS). If you define such rules, you must refresh the Control-M/Tape rules in memory. To do this, issue the following operator command:

    CopyCopied to clipboard 
    S CTTINIT,PARM='MODE=RELOAD,TBLT=RULE'

Adjusting ACS RoutinesLink copied to clipboard

Below are sample adjustments to ACS routines that enable the Control-M/Tape/DFSMS interface by assigning Management classes to relevant data sets.

Example 1

In this example, Management Class SHORTERM is assigned to all tape data sets that end with TEMP.

The same Storage Class (ATLSTK) is assigned to all tape data sets. It is assigned only to enable DFSMS to invoke a Management Class ACS routine.

Figure 46 Storage Class Adjustments

CopyCopied to clipboard 
/*****************************
//* DEFINE TAPE UNIT NAMES      */
/*******************************/
FILTLIST TAPES INCLUDE(’0420’,’0421’,’0460’,’0461’)
/******************************************/
/* SET A STORAGE** CLASS FOR TAPE DATASETS  */
/******************************************/
WHEN (&ACSENVIR='CTTOPEN' &&  &UNIT=&TAPES)
Figure 47    Management Class Adjustments
/*******************************************************/
/* SET A MANAGEMENT CLASS FOR TAPE  '*.TEMP' DATASETS  */
/*******************************************************/
WHEN (&ACSENVIR='CTTOPEN' &&  &LLQ='TEMP')
SET &MGMTCLAS = 'SHORTERM'

Example 2

In this example, tape data set DSN.WEEKLY is assigned to pool WEEKBKP, and Management Class KEEPMNTH is assigned to this data set in the Control-M/Tape Media Database (MDB).

The same Storage Class (CTTSC) is assigned to all tape data sets. It is assigned only to enable DFSMS invoke a Management Class ACS routine.

A different Management Class is assigned for each value of the &ACSENVIR parameter.

During mount processing for data set DSN.WEEKLY, Management Class WEEK is assigned to this data set. Rule 1 assigns pool WEEKBKP to this Management Class.

During open processing for this data set, Management Class KEEPMNTH is assigned to this data set and this information is recorded in the Media Database. Rule 2 causes the volume of this data set to be vaulted in vault SAFE for 10 days.

Figure 48 Storage Class Adjustments

CopyCopied to clipboard 
/*******************************
//* DEFINE TAPE UNIT NAMES      */
/*******************************/
FILTLIST TAPES INCLUDE(’0420’,’0421’,’0460’,’0461’)
/******************************************/
/* SET A STORAGE CLASS FOR TAPE DATASETS  */
/******************************************/
WHEN (&ACSENVIR='CTTOPEN' && UNIT=&TAPES)
SET &STORCLAS = 'CTTSC'
WHEN (&ACSENVIR='CTTMNTV' && UNIT=&TAPES)
SET &STORCLAS = 'CTTSC'

Figure 49 Management Class Adjustments

CopyCopied to clipboard 
/***********************************************************/
/* SET A MANAGEMENT CLASS FOR TAPE  'DSN.WEEKLY' DATASETS  */
/***********************************************************/
WHEN (&ACSENVIR='CTTOPEN' &&  &DSN='DSN.WEEKLY')
SET &MGMTCLAS = 'KEEPMNTH'
WHEN (&ACSENVIR='CTTMNTV' &&  &DSN='DSN.WEEKLY')
SET &MGMTCLAS = 'WEEK'
Figure 50    Control-M/Tape Rule 1
ON MGMTCLAS  = WEEK      And/Or/Not A
ON DATASET   = *
========================
DO POOL      = WEEKBKP
Figure 51    Control-M-M/Tape Rule 2
ON MGMTCLAS  = KEEPMNTH And/Or/Not A
ON DATASET   = *
=======================
DO VAULT     = SAFE
UNTIL DAYS 0010