Previous Topic: ACS Routine Definition / By Pattern (STGELB)

Next Topic: ACS Routine Definition / Detail (STGELB)

ACS Routine Definition / By Group (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:  This report allows users to define a series of
           data set name mask patterns, compare those
           patterns against their existing data set names,
           assign a group name when a match occurs, and then
           summarize the data based on that group name.  This
           particular report gives a summary of each of the
           assigned groups, including the number of data sets
           that would exist in the group, and the amount of
           space allocated and used by those data sets.

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

Benefit:   Many software products allow generic patterns or
           masks to be defined that are then used to assign
           processing groups to the data set based on the
           results of the pattern matching.  This report will
           help users define, test, and tune those patterns
           and groups so that software can be implemented
           faster and with fewer problems.  These types of
           patterns and groups are very common in both
           automated data management software and in data
           security products.

Features:  Because of the complexity of pattern testing, an
           assembler language format routine is called to do
           the actual testing.  This routine allows single
           character masks (%), multiple character masks (*)
           and multiple node masks (**).
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

    Construct Name Assigned
           The name of the construct for which this
           summarization applies.  A construct name may,
           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 Assigned to Group
           The number of data sets within the input data that
           matched search pattern and were assigned the
           construct name represented by this summary line.

    Percent Assigned to Group
            The percentage of data sets within the input data
            that were assigned to the construct name
            represented by this summary line.  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 assigned to this
            construct.

    Percent Space Allocated
            The percentage of the total storage space
            allocated by the data sets assigned this
            construct, 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 assigned to this construct.  Note that data
            sets included from tape and HSM will always have
            this value equal to the allocated value (unless
            you use the PRIMARY option for HSM space
            reporting).

    Percent Space Used
            The percentage of the total storage space used by
            the data sets assigned to this construct,
            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 - GROUP REPORT ABC CORPORATION ------------------------------------------------------ System Identifier=SYSA ------------------------------------------------------ Construct Data Sets Percent Megabytes Percent Megabytes Percent Name Assigned Assigned Allocated Space Used Space Assigned to Group to Group Allocated Used (NONE) 2296 68 4136.2 70 2984.6 66 DCDOCS 251 7 475.2 8 424.9 9 DCISPF 183 5 607.9 10 540.4 12 DCLIST 298 9 179.9 3 151.4 3 DCSOURCE 321 9 391.6 7 329.2 7 DCVSAMT 34 1 146.4 2 110.7 2 -------- ------------ -------- -------- SYSID 3383 5937.2 4541.3 ============ ======== ======== 3383 5937.2 4541.3


 Figure 4-3.  ACS Routine Definition / by Group