Previous Topic: 4.3 Report Descriptions

Next Topic: ACS Routine Definition / By Group (STGELB)

ACS Routine Definition / By Pattern (STGELB)


Source:    VCADAA file at the DETAIL timespan
           VCA_VS file at the DETAIL timespan
           HSMMIG file at the DETAIL timespan
           HSBBAC file at the DETAIL timespan
           Tape library information (external)

Function:  Allows users to define a series of data set name
           mask patterns, compare these patterns against
           their existing data set names, and report the
           results of these comparisons.

           Provides a summary of each pattern, the number of
           matches that occurred for the pattern, and the
           space represented by the matching data sets.

           Further information about the use of pattern files
           is available in the facility instructions at the
           end of this section.

Features:  Many software products allow generic patterns or
           masks to be defined that are then used to allow
           operations on data sets whose names match the
           mask.  This report helps users define, test, and
           tune those patterns so that software can be
           implemented faster and with fewer problems.

           This analysis reads an external file of
           user-defined data set name patterns.  This pattern
           file is then matched against each of the
           installation's data set names, with the results
           displayed on this report.  The number of data sets
           that matched none of the patterns is also
           reported.

SMS
Issues:    This report is useful for identifying the data set
           pattern masks that should be coded in SMS ACS
           routines for the purpose of assigning class and
           group names for new data sets.  Once the pattern
           file is complete, a report option can be used to
           generate a starter or skeleton ACS routine.

COLUMN DESCRIPTIONS

   Search Pattern
           Identifies the search pattern that is summarized
           on this report line.  Search patterns are defined
           in a pattern file that you define and then read
           with this program.  A value of '(NO MATCH') in
           this column is used to represent data sets that
           did not match any of the existing patterns in the
           pattern file.

   Construct Name Assigned
           The name of the construct associated with this
           search pattern that was assigned to the data sets
           in this group.  A construct name can, optionally,
           be associated with each search pattern in the
           pattern file.  The concept of constructs allows
           many data sets with similar requirements to be
           grouped as one logical entity.  For example, the
           following entries in the pattern file:

                   **.COBOL   SOURCE
                   **.ASM     SOURCE
                   **.PLI     SOURCE

           would assign data set names ending in the suffixes
           COBOL, ASM and PLI to a common group known as
           'SOURCE'.  Because these data sets all probably
           represent source code, it is logical that they
           have similar requirements and can be treated as
           one entity.  Depending on the type of ACS routine
           being written, the construct name could represent
           the name of a Data class, Storage class,
           Management class, or Storage Group.  A value of
           '(NONE)' in this column indicates that no
           construct name was assigned, either because one
           was not defined in the pattern file, or because
           the data set matched none of the search patterns.

   Data Sets Matching Pattern
           The number of data sets within the input data that
           matched the search pattern represented by this
           summary line.  A value of zero indicates a search
           pattern that did not match any data sets.

   Percent Matching Pattern
           The percentage of data sets within the input data
           that matched the search pattern represented by
           this summary line.  A value of zero indicates a
           search pattern that did not match any data sets.
           Note that data sets excluded from the analysis by
           filtering criteria are not included when
           calculating this value.

   Megabytes Allocated
           The amount of storage space, expressed in millions
           of bytes (megabytes), allocated by the data sets
           matching this search pattern.

   Percent Space Allocated
           The percentage of the total storage space
           allocated by the data sets matching this search
           pattern, expressed in millions of bytes
           (megabytes).  This is calculated by dividing the
           space allocated for this group by the total space
           allocated by all data sets in the analysis.  Note
           that data sets excluded from the analysis by
           filtering criteria are not included when
           calculating this value.

   Megabytes Used
           The amount of storage space, expressed in millions
           of bytes (megabytes), used by the data sets
           matching this search pattern.  Data sets included
           in the analysis from tape or HSM will always have
           this value equal to the allocated value (unless
           you specify the PRIMARY option for HSM space
           reporting).

   Percent Space Used
           The percentage of the total storage space used by
           the data sets matching this search pattern,
           expressed in millions of bytes (megabytes).  This
           is calculated by dividing the space used for this
           group by the total space used by all data sets in
           the analysis.  Note that data sets excluded from
           the analysis by filtering criteria are not
           included when calculating this value.

ACS ROUTINE DEFINITION (STGELB) CA MICS StorageMate - PATTERN REPORT ABC CORPORATION ------------------------------------------------------ System Identifier=SYSA ----------------------------------------------------- Search Pattern Construct Data Sets Percent Megabytes Percent Megabytes Percent Name Matching Matching Allocated Space Used Space Assigned Pattern Pattern Allocated Used TMPVSM.** DCVSAMT 34 1 146.4 2 110.7 2 **.*LIST DCLIST 298 9 179.9 3 151.4 3 **.COBOL DCSOURCE 0 0 0.0 0 0.0 0 **.ASM DCSOURCE 58 2 194.7 3 170.5 4 **.PLI DCSOURCE 0 0 0.0 0 0.0 0 **.CNTL DCSOURCE 263 8 196.9 3 158.7 3 **.*TEXT DCDOCS 251 7 475.2 8 424.9 9 **.ISP%LIB DCISPF 183 5 607.9 10 540.4 12 (NO MATCH) (NONE) 2296 68 4136.2 70 2984.6 66 -------------------------------------------- ------------ -------- -------- SYSID 3383 5937.2 4541.3 ============ ======== ======== 3383 5937.2 4541.3


 Figure 4-2.  ACS Routine Definition / by Pattern