Previous Topic: 3.2.24 Post Processor Enterprise Disk Systems

Next Topic: 3.3 Management Objective Reports

3.2.25 Sysplex Aggregation Compliance Report


The Sysplex Aggregation Compliance report provides, for every
machine (CPC) analyzed, the average contribution of each z/OS
logical partition to the Sysplexes' workload, over an
expected 40 hours prime shift period.  Based upon IBM's
Parallel Sysplex Aggregation rules, the report also
determines which Sysplex, if any, a machine belongs to.

INTENDED USE:

IBM's Parallel Sysplex Aggregation allows customers to
receive software pricing benefits by adding together software
licenses in a Parallel Sysplex in order to price them as a
single entity.  To qualify for aggregation, a Sysplex must
meet all IBM's criteria in the hardware, software, and
operational categories.

The Sysplex Aggregation Compliance report is intended to help
you assess whether your machines meet the Parallel Sysplex
Aggregation 50% operational criterion:  on a given machine,
the images participating in the Parallel Sysplex must account
for at least 50% of the workload on the machine in order to
belong to this Sysplex.

This report is designed to enable you to analyze your Sysplex
environment for compliance with the LPAR usage criterion of
IBM's Parallel Sysplex Aggregation rules.  It assumes but
does not verify your compliance with the other criteria for
aggregation.

Use of the Sysplex Aggregation Compliance report is not
designed to arrive at a conclusive determination of your
eligibility for Parallel Sysplex Aggregation. This
determination may only be made by IBM.

REPORT FORMAT:

This inquiry produces a single page table for each reported
period of 40 hours from 5 consecutive business days.


S Y S P L E X A G G R E G A T I O N C O M P L I A N C E R E P O R T Page 001 Customer Name : XYZ Corp. Reporting Period: 19NOV07:09:00 - 23NOV07:17:00 Machine: CPC1 Serial: p0963 MSUs Rating: 742 Model: 2094-S28(712) Logical Partitions ------------------ LPAR Operating System Contribution Name Sysid System Name Sysplex Pct MSUs Notes (may affect reporting accuracy) -------- ----- ------------ -------- -------- ------ ------ --------------------------------------------------- CF01 No data for this LPAR was provided. ZOS1 ZOS1 z/OS 1.8 ZOS1 PLEXC1 31.2% 88 0h55 of data missing out of the 40h00 expected. ZOS2 No data for this LPAR was provided. ZOS3 ZOS3 z/OS 1.8 ZOS3 PLEXC1 51.0% 143 VM01 No data for this LPAR was provided. ZPR1 ZPR1 z/OS 1.8 ZPR1 PLEXC1 12.8% 36 ZQA1 ZQA1 z/OS 1.8 ZQA1 PLEXC1 5.0% 14 Based on the above information, the Primary Sysplex for CPC1 is: PLEXC1 ========================================================================= Machine: CPC2 Serial: p6193 MSUs Rating: 247 Model: 2064-1C7 Logical Partitions ------------------ LPAR Operating System Contribution Name Sysid System Name Sysplex Pct MSUs Notes (may affect reporting accuracy) -------- ----- ------------ -------- -------- ------ ------ --------------------------------------------------- DRP1 No data for this LPAR was provided. XAZ1 XAZ1 z/OS 1.8 XAZ1 PLEXD1 27.2% 35 XAZ2 XAZ2 z/OS 1.8 XAZ2 PLEXP1 61.2% 79 XAZ3 XAZ3 z/OS 1.8 XAZ3 PLEXD1 11.6% 15 Based on the above information, the Primary Sysplex for CPC2 is: PLEXP1 =========================================================================



 Figure 3-25. Sysplex Aggregation Compliance report
FIELDS DESCRIPTION

The report is broken in to four sections in the following
order:  header, machine overview, LPAR summary, and
conclusion.  The general layout of the report is:

+-- Header (describes the reporting period)
!
!   +-- Machine 1 overview (general characteristics of CPC1)
!   !
!   !   +-- LPAR summary (list all LPARs' contribution)
!   !   !   ...
!   !   !   ...
!   !   +-- ...
!   !
!   +-- Conclusion (primary Sysplex determination for CPC1)
!
!   +-- Machine 2 overview (general characteristics of CPC2)
!   !
!   !   +-- LPAR summary
!   !   !   ...
!   !   !   ...
!   !   +-- ...
!   !
!   +-- Conclusion (primary Sysplex determination for CPC2)
+--

Each section is explained below:

Header section
--------------

Customer Name:  The name of the customer as specified in the
MICF execution panel.

Reporting Period:  The starting and ending times of the prime
shift.  This field can be used to control if the information
stored in the CA MICS database covers the expected amount of
data, representing 40 hours from 5 consecutive business days.
We will use the following week as a reference for all
examples listed in this section:

  Mon, November 19, 2007
  Tue, November 20, 2007
  Wed, November 21, 2007
  Thu, November 22, 2007
  Fri, November 23, 2007
  Sat, November 24, 2007
  Sun, November 25, 2007

By default, the prime shift is 9am-5pm, Monday through
Friday.  This would show up as the following reporting
period:

  19NOV07:09:00 - 23NOV07:17:00

When the Sysplex Aggregation Compliance report is executed
using the DETAIL or DAYS timespans, the default reporting
period can be altered in three ways:

  1) Modify the prime shift starting day:  Any day of the
     week can be chosen as the starting day of the period.
     The reporting program will automatically extend the
     input data selection for 5 days from the starting day.
     For example, if your prime shift starts on Wednesdays,
     the reporting period will be 9am-5pm, Wednesday through
     Sunday:

       21NOV07:09:00 - 25NOV07:17:00

  2) Modify the prime shift starting hour:  Any hour of the
     day can be chosen as the starting hour of the period
     (this can be combined with a modified starting day as
     described above).  The reporting program will
     automatically extend the input data selection for 8
     hours from this time.  For example, if your prime shift
     starts at 8am, the reporting period will be 8am-4pm,
     Monday through Friday:

       19NOV07:08:00 - 23NOV07:16:00

  3) Exclude lunch time hours:  Up to two consecutive hours
     may be excluded from the input data.  This can be useful
     if you do not want to consider lunch time utilization as
     being part of your prime shift pattern.  The reporting
     program will automatically extend the input data
     selection for 8 hours from the starting hour and exclude
     the lunch time interval.  For example, using the default
     prime shift, if you want to remove two lunch hours
     (12am-2pm), the reporting period will be 9am-12am and
     2pm-7pm, Monday through Friday, and the excluded hours
     will be displayed:

     19NOV07:09:00 - 23NOV07:19:00
     (Lunch Time Excluded: 12:00-13:59)

When the Sysplex Aggregation Compliance report is executed
using the WEEKS timespan, you must supply the CA MICS zones
that represent your prime shift.  You can also use zone
selection with the DETAIL or DAYS timespans, but this is
mutually exclusive with the prime shift specifications
described above.  Therefore, you should carefully review your
CA MICS parameters in order to supply the correct zones to
the program.  Although no verification is performed against
the zone setup, an additional note will be displayed next to
the reporting period field:

  19NOV07:09:00 - 23NOV07:17:00 (CA MICS zone selected: 1)

Machine overview section
------------------------

Machine:  An arbitrary designation of the machine in the form
CPCn where n is incremented by one each time a different
machine is found within the reporting period.

Serial:  The unique serial number of the machine in the form
"pnnnn" where nnnn are the last four digits of the processor
serial number.

MSUs Rating:  The software MSU rating for the machine being
analyzed.

If a master LPAR (for example PRD1) has been specified for
this machine on the MICF execution panel, a note will
immediately follow the machine specifications:

  NOTE: All LPAR timestamps have been adjusted to the
        specified master LPAR, PRD1.

LPAR summary section
--------------------

This section provides a table containing the information for
all the active logical partitions in the machine that are
using general purpose processors.  The Sysplex calculations
can only be performed for LPARs that produced SMF type 70
subtype 1 records.

If the program detects that no SMF records exist for an LPAR,
all columns will be empty, and a note will be displayed.
Otherwise the following information is provided for each
LPAR:

LPAR Name:  The name of the logical partition.

Sysid:  The SYSID name for the instance of z/OS running in
the logical partition.

Operating System: The O/S and level of the logical partition.

System Name:  The system name for the instance of z/OS
running in the logical partition.

Sysplex:  The Parallel Sysplex name for the logical
partition.

Contribution Pct:  The average utilization contribution (in
%) of the LPAR's workload, as a percentage of workload on the
machine over the reporting period.  zAAP/zIIP special
processors are included in the calculations.

Contribution MSUs:  The average utilization contribution (in
MSUs) of the LPAR's workload, over the reporting period.
zAAP/zIIP special processors are included in the
calculations.

Notes:  For each logical partition, various notes may appear
in this column.  This is an indication that the report
accuracy may be affected.  These notes can be one of the
following:

  "No data for this LPAR was provided":  The data covered by
  the reporting period does not contain any information for
  this logical partition (originally no SMF type 70 subtype 1
  record).  This is not necessarily a problem if this LPAR is
  not a z/OS system (for example VM, coupling facility).
  But, if it is a z/OS system, its potential contribution to
  a Sysplex activity cannot be assessed.

  "HHhMM of data missing out of the 40h00 expected":  The
  data for the logical partition is incomplete.  If the same
  amount of data is missing for all LPARs, one reason may be
  that the reporting period does not cover a full prime
  shift.

Conclusion section
------------------

This section provides the primary Sysplex determination.
Based on the logical partitions' contributions to the various
sysplexes, the program displays the name of the sysplex the
machine belongs to.  It is either the name of the Sysplex
that generates at least 50% of the workload of the machine,
or *NONE* if no Sysplex reaches the 50% limit.

A sysplex name means aggregation with other machines is
possible, *NONE* means the machine cannot aggregate.

DATA SOURCE (file/timespan):

HARCPU and HARLPC at the DETAIL, DAYS, or WEEKS timespan.

DATA ELEMENTS USED AND CALCULATIONS:

Consult the SAS source code used to generate this report
in sharedprefix.MICS.SOURCE(@RMFSPX1).

HOW TO PRODUCE THE REPORT:

o Enter the CA MICS Workstation Facility (MWF).

o Choose option 2, CA MICS Information Center Facility
  (MICF).

o Choose option 2, Database Inquiries.

o Select RMFLPU, whose Catalog Group is PERFORM.

o Complete the MICF Execution panel. (If you are not
  familiar with MICF, see the MICF User Guide and the MICF
  Reference Guide.)

o Complete the specification panel illustrated below.
  (Descriptions of the fields follow the panel.)

+----------------------------------------------------------------------+ |------------ Sysplex Aggregation Compliance Report -----------------| | Command ===> | | | | Composing Inquiry: RMFLPU - Sysplex Aggregation Compliance Report | | Database ===> ___________ | | Cycle(s) ===> __ - __ | | Timespan ===> ______ (DETAIL/DAYS/WEEKS) | | | | Customer Name ===> ________________________________________ | | | | Prime Shift Selections: | | | | Starting Day ===> ___ - Hour ===> __ Lunch Hours ===> __ - __| | or | | CA MICS Zone ===> _ _ _ _ | | | | Master LPARs (CPC serial number last 4 digits followed by LPAR name):| | ===> ____ ________ - ____ ________ - ____ ________ - ____ ________| | ===> ____ ________ - ____ ________ - ____ ________ - ____ ________| | ===> ____ ________ - ____ ________ - ____ ________ - ____ ________| | ===> ____ ________ - ____ ________ - ____ ________ - ____ ________| | ===> ____ ________ - ____ ________ - ____ ________ - ____ ________| +----------------------------------------------------------------------+



    Database - Required. No default.
      Specify up to six database unit IDs (the IDs of the
      CA MICS database units from which the files are read).
      If CA MICS files exist in only one database unit, this
      parameter is set automatically.  To display a selection
      list of valid database unit IDs, specify ? (question
      mark).


     Cycle(s) - Required.  Defaults to 01.
       Specify 00-99 in either data entry field; leading
       zeros are inserted automatically.  The CA MICS files
       cycle (specify first field) or cycle range (specify
       both fields) for the inquiry execution.  It is
       important, for the accuracy of the report, that enough
       cycles be specified to cover IBM's view of the prime
       shift (40 hours from 5 consecutive business days).

     Customer Name - Required.  No default.
       Specify the customer name that will be displayed in
       the header of the report.

     The default reporting period is 9am to 5pm, Monday
     through Friday (40 hours).  If necessary, you can
     specify a different range of days and/or hours to match
     your own prime shift patterns.  You can also exclude up
     to 2 consecutive hours per day if you do not want to
     consider lunch time utilization.  This facility is only
     available with the DETAIL and DAYS timespans, when no CA
     MICS zone is specified.  If the WEEKS timespan is used
     or if CA MICS zones are selected, these zones are
     expected to represent your complete prime shift.

     Starting Day - Optional.  Defaults to MON.  MON-SUN.
       Specify the starting day of your prime shift.  Valid
       with DETAIL and DAYS only.

     Starting Hour - Optional.  Defaults to 09.  00-23.
       Specify the starting hour of your prime shift.  Valid
       with DETAIL and DAYS only.

     Lunch Hours - Optional.  No default.  00-23.
       Specify up to two consecutive hours to exclude from
       the report. Valid with DETAIL and DAYS only.

     CA MICS Zone - Required with WEEKS, otherwise optional.
     No default. 1-9.
       You can specify up to four zone values.  An input
       observation is selected if its zone value is equal to
       any of the specified values.  Because this parameter
       is mutually exclusive with the other prime shift
       specifications, it is expected that the selected
       period represents your entire prime time (40 hours
       from 5 consecutive business days).  Otherwise, the
       report may draw incorrect conclusions.

     Master LPARs - Optional. No default. CPC serial number
     last 4 digits followed by LPAR name.
       You can specify which LPAR (for up to 20 machines)
       represents local time in the event that different
       LPARs are running in different time zones.  All other
       LPARs' timestamps will be adjusted to match the
       master.  If no LPAR is explicitly specified, the most
       contributing one will be considered as the master.

USAGE CONSIDERATIONS:

This inquiry provides a user exit that you can use to perform
additional data selection from the CA MICS database.  To
invoke this exit, you must first copy the shared inquiry into
your private MICF catalog, then select it for modification.
Finally code SAS statements in the SELECT macro, bracketed by
the %MACRO and %MEND statements.
 
The default for the SELECT macro is null.  This macro is
invoked when the observations are read from the specified
CA MICS file(s).  You can use it to delete observations from
the data as it is selected.  For example, in a system
activity study, you might want to exclude test systems
starting with a T from the analysis.  You would then code
the following:
 
     %MACRO SELECT;
     IF SYSID NE: 'T';
     %MEND  SELECT;
 
Note that you do not have to code the %MACRO and %MEND
statements, as they are already provided for you.
 
IMPORTANT:  You must code each specified SAS statement in
accordance with the syntax of the SAS Macro Language, as
described in the SAS manuals.  No validity checking is done
on the defined code.  If the user code contains syntax or
logic errors, the inquiry will either terminate abnormally or
will produce unpredictable results.

************************************************************
**  Note:  This report cannot be produced if the CA MICS  **
**         database contains essential data elements only.**
************************************************************