3. CUSTOMIZING CA MICS StorageMate › 3.2 Establish Global Processing Options
3.2 Establish Global Processing Options
The activities described in this section must be performed
when the CA MICS StorageMate product is installed. They can
be performed later, however, if you want to change any of the
global processing options. Do this with caution, however,
because these changes will apply to all users of the product.
If you are installing the StorageMate product for the first
time, do not perform the activities described in this section
until directed to do so by the checklist in Appendix B.
The global options described here are set by the person
installing the product and will affect the way the product
operates for all users. Each global option is set by
modifying a member called $STGEXIT that resides in the
sharedprefix.MICS.SOURCE data set. Review each suggested
change below to see if they apply to your installation. You
may want to contact your CA MICS System Administrator if you
have questions about them. Before making any of the changes
suggested below, save an original copy of your $STGEXIT
member in your sharedprefix.MICS.LOCALMOD.CNTL data set.
Debugging Options
-----------------
A statement within the $STGEXIT member appears as follows:
%LET STGDEBUG = N;
This statement sets CA MICS StorageMate debug mode to active
(= Y) or inactive (= N). Currently, the only function of
debug mode is that it issues a warning message when it
detects a data set name that is not found in a specified Data
Set Group Table. You may consider activating debugging mode
(= Y) when defining your initial Data Set Group Tables and
then deactivating it (= N) later.
SAS Source Options
------------------
A variable named STGSASOP is defined within the $STGEXIT
member and is used to set the SAS source options for every
CA MICS StorageMate report that is requested. As defined,
the STGSASOP variable contains no option statements. If you
want to permanently modify the SAS execution options for all
CA MICS StorageMate reports, you can set the STGSASOP
statement to include the options that will appear on the SAS
OPTIONS statement. The word OPTIONS should not be coded, but
only a list of the options that will be activated. A common
use of this facility would be to request the printing of
source statements before calling the support group for a
detected problem. An example of how you might do this is as
follows:
%LET STGSASOP = SOURCE MACROGEN;
Use of Asterisk for Data Filtering
----------------------------------
The CA MICS StorageMate Data Filtering panel allows the
filtering of several data elements that contain character
values, such as data set name or volume serial number. This
panel will also allow generic specification of character
values, also known as prefixing. The way the product is
distributed, this generic specification is requested by using
an asterisk as the last character specified. For example,
you can select a report and ask for filtering by volume and
specify the following values: SYSRES SPOOL1 TSO* IMS*.
These values would then select volumes with serial numbers
SYSRES, SPOOL1, plus any numbers with the prefix TSO or IMS.
Specifying TSO without the asterisk would only select a
volume if it had a serial number of TSO followed by three
blanks. While this is not common in most installations, it
is possible.
The use of an asterisk was chosen for consistency. Many
other ISPF and storage management products use an asterisk as
the last character to indicate a generic or prefix value.
An option is provided, however, that makes CA MICS
StorageMate always treat every value as a prefix, eliminating
the need to enter an asterisk as the last character. Find a
statement in the $STGEXIT member that appears similar to the
following:
%LET STGASTER = Y;
As distributed, the value of 'Y' indicates that an asterisk
must always be coded as the last character of a filtering
value if it represents a prefix. Change this to 'N' if you
want all short values to be considered prefixes.
Duplicate Data Options
----------------------
The StorageMate product is distributed assuming that no
repetitive data will exist in any of the data files used by
the product. Most installations run VCC once per day and
convert that data into a VCA cycle. Some installations,
however, have chosen to run VCC multiple times throughout the
day and have all that data combined into one VCA daily run
and one VCA/HSM cycle. An option is present in CA MICS
StorageMate that can eliminate this repetitive data, but this
option must be requested. Locate the statement within the
$STGEXIT member that appears similar to the following:
%LET STGREPOP = NONE;
Change the value following the equal sign (=) to be one of
the following:
NONE
This option causes no checking to be done for repetitively
collected data. Code this option if each VCA cycle
represents only one execution of VCC for each system.
MERGE
Code this option to merge all data so that only the latest
time stamp for each volume or data set will be included.
For example, if you ran VCC at noon for volumes A and B and
at 6 p.m. for volumes B and C, the noon data for volume A
and the 6 p.m. data for volumes B and C would be included
in the analysis. This is probably the best option to use if
you have repetitively collected data.
LAST
Code this option if you want only data from the last time
stamp found within the data to be used in the analysis. For
example, if you ran VCC at noon for volumes A and B, and at
6 p.m. for volumes C and D, only data for volumes C and D
would be included. Use this option if you run VCC
throughout the day for selected volumes, and then at the end
of the day for all volumes.
As distributed, this option is set to NONE, so that no
checking for repetitively collected data is performed. Note,
however, that there is one exception to this process. Some
StorageMate reports allow you to enter a range of cycle
numbers when you specify the report options. In this case,
if you request multiple cycle numbers you would get
repetitively collected data, even if each VCA cycle
represents only one execution of VCC. To avoid this problem,
CA MICS StorageMate will automatically invoke the MERGE
option if:
1) Option NONE was specified or defaulted in the
$STGEXIT member and
2) A range of cycle numbers was entered on the report
options panel when executing a report.
If you code an option to eliminate duplicate data and no
duplicates are found, there will be no effect on the final
output. Note, however, that extra processing steps are added
for this feature that will use more time and resources than
would be used if STGREPOP was set to NONE.
Report Titles
-------------
The default title lines appearing at the top of each CA MICS
StorageMate report are all defined in the $STGEXIT option
member. Thus, you can change these definitions if you want
to have alternate titles on your reports. Use this option
with caution, however, as it will apply to all reports
executed by all users of the product. Note also that an
alternate title may cause confusion when requesting technical
support for a problem with one of your reports.
The default titles that appear on each report are in the
following format:
(title 1) Report Title (REPORT-ID)
(title 2) CA MICS StorageMate Vx.x - Specific Report
(title 3) Installation Name - Date
Most of these defaults can be changed by modifying control
statements in the $STGEXIT member. The statements shown
below already exist in $STGEXIT, and just need to be modified
to contain the correct values:
(#1) %LET STGExx01 = Report Title;
(#2) %LET STGExxyy = Specific Report;
(#3) %LET STGTTL02 = CA MICS StorageMate Vx.x;
(#4) %LET STGTTL03 = Installation Name;
(#5) %LET STGTTLDT = NO;
Line #1 exists for every separate StorageMate report, and
specifies the value of the title 1 line. STGExx represents
the unique Report ID (MICF ID) of each report.
Line #2 exists for those reports that support a number of
different output reports, such as a SUMMARY report and a
DETAIL report. The value STGExx is as described above, while
the yy portion will be a numeric value 02-99.
Line #3 specifies the default value for title 2. The default
is the name of the StorageMate product, and its current
version number.
Line #4 specifies the default value for title 3. The default
is the name of your installation, as specified by your
CA MICS Administrator when CA MICS was installed.
Line #5 specifies if the date should appear in the 3rd report
title line. Specify a value of YES or NO. Depending on your
SAS options, SAS may print a date, time, and page number in
the upper corner of each report page. But if this option is
not active, you may want to activate this option and print
the date on the 3rd title line.
For color graphics, you always have the option of changing
title lines 2 - 4 on the report option panel. You should
probably not use these global options for color graphics
changes, unless you want these changes to apply for all
users, or you cannot get the titles you desire with the
options provided.
Production Reporting Options
----------------------------
All StorageMate reports will execute in a MICF Production
Reporting environment. This is done by setting certain
defaults that will be in effect for each report that is
selected for production reporting. There are some defaults,
however, that could never be set in a way that would be
satisfactory for all users. One example is if a report was
needed to access a Work Data Set. For this reason, some
defaults are set by options in the $STGEXIT member.
If you are planning to use some of the StorageMate reports
under the MICF Production Reporting facility, you may need to
define some production data sets and define those data sets
to the $STGEXIT member. A description of these options is
not given here. If you are planning to use MICF Production
Reporting with this product, please edit the $STGEXIT member
and look for the comment relating to options for the MICF
production reporting facility. Review the options under that
heading and make any necessary changes. The function of each
option will be described by the comments in the member.
