Previous Topic: 2.8.2 Control ParametersNext Topic: 2.9 CICS Resource Planning


2.8.3 Standard Output

 
The capacity planning database file generated by the SMS
Planning Sample Application contains the following data
elements:
 
A.  Data elements common to all CA MICS Capacity Planner
    database files:
 
    SYSID
    ZONE (Always  equal to "A") - see Note)
    YEAR
    MONTH or WEEK or MNTHDAY
    DATE
 
 
Note: The VCA Information Area database files do not use the
      ZONE variable.  The SMS Resource Planning Sample
      Application automatically sets the ZONE variable to A.
      Code an A where a ZONE value is required when using the
      component's trending programs.

B.  Data elements unique to the SMS Resource Planning Sample
    Application database file:
 
    1.  Character format data elements
 
        CAPAPU   - SMS  Storage Category

    2.  Numeric format data elements
 
        DAAALLSP - Amount of Space Allocated (Mbytes)
                   (for each Storage Category)
        DAAUSESP - Amount of Space Used (Mbytes)
                   (for each Storage Category)
        MBALOC   - Megabytes Allocated for system
        MBTOTL   - Megabytes Total for measured system
        MBUSED   - Megabytes Used for system
        PCATRAL  - Percent of Total Allocation for CAPAPU
                   (for each Storage Category)
        PCATRUS  - Percent of Total Usage for CAPAPU
                   (for each Storage Category)
        PCTALOC  - Percent Allocated for System
        PCTUSED  - Percent Used for System
        STGVOLNO - Total Volumes for Storage Group
                   (Present only if CAPAPU=GROUP)
DERIVATION OF THE SMS PLANNING DATA FILE ELEMENTS
 
The following paragraphs discuss the DASD Planning database
file elements.
 
CAPAPU:   The data element that contains the values found
          either in STORNAME, STORSTGC, STORMGTC, or values
          derived within the user's exit.  In the capacity
          planning database, there is a separate observation
          for each value of CAPAPU for each MONTH, WEEK or
          DAY.  In addition to the groups defined, there will
          be an observation for a CAPAPU value of "**OTHER**"
          that represents all the storage space having blank
          values for CAPAPU from STORNAME, STORSTGC, or
          STORMGTC.  It is recommended, but not required,
          that, if the you write an exit, this exit provide a
          catchall category like "**OTHER**".

STGVOLNO: This is obtained from VCAVOA, if CAPAPU is set to
          storage group (STORNAME).  Its creation is skipped
          if any CAPAPU other than storage group is selected.
In the calculation of the numeric data elements, the elements
that are used from the CA MICS VCAVOA and VCADAA Files are
the following:
 
    DAAALLSP - Amount of Space Allocated (Mbytes)
    DAAUSESP - Amount of Space Used (Mbytes)
    VOACAPMB - Total Capacity of Volume in Megabytes
The data elements DAAALLSP, DAAUSESP, MBALOC, MBUSED, and
MBTOTL all represent average usage statistics for the
timespan being considered (that is, MONTH).  Over the span
of a month, actual use may vary considerably as SMS volumes
are installed or discontinued, and data sets are allocated,
extended, released, or scratched.

During the summarization process, VOAVOLNO is used to weigh
the individual observations from the VCAVOA File and DAASAMPL
is used to weigh the individual observations from the VCADAA
File. This allows the numeric data elements contained in the
capacity planning database file to be calculated correctly,
even if a volume resided on more than one device type during
a month, or a particular category of data sets was present
during only a part of a month.

The data elements from the VCAVOA and VCCDAA Files that are
used to compute the DASD Planning file elements are
themselves derived from the CA MICS VTOC Catalog Collector
(VCC) Component.  This product performs a periodic scan on
all volumes that are defined to it.  The elements defined
next represent averages over all scans taken during the
month.
 
DAAALLSP: The amount of space allocated for each CAPAPU. This
          value is computed as the sum of DAAALLSP for each
          unique value of CAPAPU.

DAAUSESP: The amount of space used for each CAPAPU. This
          value is computed as the sum of DAAUSESP for each
          unique value of CAPAPU.

MBALOC:   The total allocated space in the measured system.
          This value is computed as the sum of DAAALLSP for
          the entire measured system.

MBUSED:   The total used space in the measured system. This
          value is computed as the sum of DAAUSESP for the
          entire measured system.  It represents productively
          used space since this space always contains some
          sort of data, either user or system defined.
          Because used space must be allocated, MBALOC is
          always greater than MBUSED. This space is allocated
          for the growth of existing data sets and therefore
          is not available for the addition of new data sets.
          The difference between MBALOC and MBUSED is the
          space that is allocated, but unused.  A large
          amount of unused space indicates that a
          considerable amount of space has been reserved by
          current users, but is not being used.

MBTOTL:   The total space in the measured system. This value
          is computed as the sum of VOACAPMB for each VOLSER
          measured.
 
Note that the above data element definitions have all been
expressed in units of megabytes.  For purposes of the SMS
Planning Sample Application, a megabyte is defined as
1,000,000 bytes.  This is consistent with published
specifications for storage devices and with other SMS-related
calculations performed for files in the VCA information area.
Percentage values have these definitions and derivations:
 
PCTUSED:  Percent used for measured System.  The percent of
          total space for the measured system which is used.
 
          PCTUSED = 100 * (MBUSED / MBTOTL)

PCTALOC:  Percent allocated for measured system.  The percent
          of total space for the measured system which is
          allocated.
 
          PCTALOC = 100 * (MBALOC / MBTOTL)

PCATRAL:  Percent of total allocation for CAPAPU.  The
          percent of total allocated space for the measured
          system which is allocated for a particular CAPAPU
          category.
 
          PCATRAL = 100 * (DAAALLSP / MBALOC)

PCATRUS:  Percent of total usage for CAPAPU.  The percent of
          total used space for the measured system which is
          used for a particular CAPAPU category.
 
          PCATRUS = 100 * (DAAALLSP / MBUSED)