Previous Topic: 3. CUSTOMIZING CA MICS StorageMate

Next Topic: 3.2 Establish Global Processing Options

3.1 Defining Data Sets and Options


There are two external data sets that need to be identified
to CA MICS StorageMate by each individual user before they
attempt to use the product.  These data sets are the:

o Work Data Set
o Tape Data Set

A space reporting option also needs to be set, so StorageMate
will know which method to use when reporting space usage for
data sets managed by HSM.

The functions of these data sets and options, and the
procedure for defining them to CA MICS StorageMate are
described below.

The Work Data Set


ALLOCATING THE WORK DATA SET

Before using CA MICS StorageMate, you must allocate a data
set that communicates with the StorageMate product.  This
data set, known as the Work Data Set, is a PDS that contains
Volume Group Tables, Data Set Group Tables, generated JCL,
data set name pattern masks, the sample ACS routines created
from those masks, and other input or output members
associated with other StorageMate facilities.

The Work Data Set is defined by choosing the "Data Sets and
Processing Options" selection from the StorageMate and MICF
Options menu, and then completing the "Work data set" area on
the panel.  The default Work Data Set name is
"userpref.MICSSTOR.CNTL", where userpref is the default
prefix for your TSO Userid.  You can change this default name
to any valid TSO data set name.  If you specify a data set
name that has not yet been created, you are shown a secondary
allocation panel that creates the new data set for you.
(This panel is similar to ISPF option 3.2).  You should also
establish the practice of periodically compressing the Work
Data Set, and removing outdated or superseded members.

WORK DATA SET INTEGRITY

StorageMate users must recognize the importance of the Work
Data Set, and know that it is not automatically backed up by
CA MICS.  If you do not have a regular backup procedure in
place for these types of data sets, you may want to build
some backup jobstreams and have them executed on a regular
basis either by the users or by a product administrator.
While many types of products can be used to perform this
backup, the example shown below uses the IEBCOPY utility to
back up a Work Data Set to tape:

//BKUPJOB    JOB  (accounting-parameters)
//BKUPWDS    EXEC PGM=IEBCOPY
//*
//* PRIVATE WORK DATA SET BACKUP TO TAPE
//*
//SYSPRINT   DD SYSOUT=*
//SYSUT1     DD DISP=SHR,DSN=userpref.MICSSTOR.CNTL
//SYSUT2     DD DSN=userpref.MICS.MICSSTOR.CNTL(+1),
//           DISP=(NEW,CATLG,DELETE),UNIT=unit,
//           DCB=(userpref.MICSSTOR.CNTL),
//           LABEL=(1,RETPD=360)
//SYSUT3     DD UNIT=SYSDA,SPACE=(TRK,(3))
//SYSUT4     DD UNIT=SYSDA,SPACE=(TRK,(3))
//SYSIN      DD *
             COPY INDD=SYSUT1,OUTDD=SYSUT2
/*

The Tape Data Set


CREATING THE TAPE DATA SET

While no information about the tapes in your tape library
currently exists in the CA MICS databases, a method has been
provided for optionally including this information in some of
the reports produced by the CA MICS StorageMate product.

You must first extract information about your tape library
and place that information in a data set available to CA MICS
StorageMate.  Appendix C of this guide provides full details
on the creation of this data set.  While this data set may be
prefixed with a TSO Userid, consider using a common prefix if
multiple users will be running CA MICS StorageMate and
accessing the data.  Note also the data set will need to be
refreshed regularly if you want it to contain the most
current information about your tape library.  You may want to
schedule a daily production job that will do this, if you
plan to use the data from this data set on a daily basis.

SPECIFYING THE NAME OF THE TAPE DATA SET

Once the external tape data set has been built, you must
supply its name to CA MICS StorageMate.  Choose the "Data
Sets and Processing Options" selection from the StorageMate
and MICF options menu, and then complete the "Tape data set"
area of the panel.  The first time you invoke the option, the
default name of the tape data set will be
"userpref.MICSSTOR.EXTAPE", where userpref is the default
prefix for your TSO Userid.  Replace this name with the name
you chose for your Tape Data Set.  The name you specified
will be saved in your profile and will be used whenever you
specify that tape information be included in a StorageMate
report.  Even if your Tape Data Set is created using the
default name shown above, you must still use this option
screen to update your profile with the correct name.

Each individual user of CA MICS StorageMate must perform this
step if they want to use tape data.  Once your Tape Data Set
is defined, you need not be concerned about this option again
unless the name of the Tape Data Set changes, or you change
your TSO Userid.

Specifying a tape data set name does not automatically
include tape data in all future StorageMate reports.
Whenever you execute a StorageMate report that supports input
from multiple sources, you are given the option on the report
screen to specify the report sources that should be used for
that report execution.

HSM Space Reporting Options


OPTIONS AVAILABLE FOR HSM SPACE REPORTING

StorageMate supports reporting for data sets that are under
control of HSM.  Data sets fall under HSM control in one of
two situations.  In one case, data sets that have not been
referenced recently have been moved from your online or
"primary" volumes to HSM migration volumes.  In the second
case, one or more backup copies of the data sets on your
primary volumes have been made on the HSM backup volumes.  In
either case, the space used on the HSM volumes for storing a
data set is probably far less than the original amount of
space allocated by the data set on the primary volume.  This
is because HSM uses such techniques as compression and data
packing, and does not allocate any more space than is
necessary to contain the data.

CA MICS maintains three different values to indicate the
amount of space allocated by a data set under HSM control,
and StorageMate may be set to use any of these options when
reporting space allocated by data sets on HSM volumes.  These
three values and their meanings are as follows:

ACTUAL - refers to the actual amount of space being used on
the HSM volume to contain the data.

PRIMARY - refers to the original amount of space that was
allocated on the primary volume by the data set before HSM
took control of it.

ESTIMATE - indicates an estimate of the amount of space that
would be required if HSM moved the data set back to a primary
volume.

SELECTING THE REPORTING OPTION

Once you have selected one of the options described above,
you must indicate your choice to CA MICS StorageMate.  Choose
the "Data Sets and Processing Options" selection from the
StorageMate and MICF options menu, and then complete the "HSM
space value" area of the panel with one of the three keywords
shown above.

The option you have selected will then be used for all future
HSM space reporting until you change it to a different value.
When you run a StorageMate report that includes HSM data, a
message in your MICSLOG output report will remind you of the
option you are currently using.  Running the same report with
different HSM space options is a good method for doing
disaster recovery planning, or for measuring the
effectiveness of HSM processing.