Previous Topic: 3.2.11 Address Space zAAP CPU Activity Report

Next Topic: 3.3 Management Objective Reports

3.2.12 Address Space zIIP CPU Activity Report

The Address Space zIIP CPU Activity Report provides an
address space perspective of zIIP processor usage by zIIP
eligible address spaces by WLM Service Class or Report Class.

INTENDED USE:

The report shows how effectively zIIP processors are being
used by address spaces that utilize the specialized
processing unit.  This report can also be used to evaluate
how much workload is zIIP eligible, to determine if it would
be beneficial to redirect activity to zIIP processors.

REPORT FORMAT:

The Address Space zIIP CPU Activity Report contains the
following sections:

  o  Identification
  o  Service Class / Report Class Summary
  o  Total for Service Class / Report Class
  o  Total for Sysplex


Identification Section

   Report                   Timespan used to produce the
                            report

   Report Range             The selected beginning and
                            ending reporting period

   Sysplex Name             Name of the sysplex from which
                            the data originated

   zIIP Normalization       Factor that was used to convert
   Factor                   zIIP CPU time into the equivalent
                            of a standard CP (PGMSUPNF)


   Sorted by                Sort order of the report within
                            each Service/Report Class: either
                            zIIP Eligible CPU Time,
                            Normalized zIIP CPU Time, or zIIP
                            Utilization Percentage in
                            ascending or descending order


Service Class / Report Class Summary

   Service Class*           The Service/Report Class to
   Report Class*            which the address space belongs
                            (WLMCLASS/WLMRPTCL)

   Job Name                 Job Identifier

   Address Space Type       Batch, TSO, Started task,
                            APPC/MVS ASCH, Scheduled
                            transaction program (TP),
                            system address space (SAS)
                            subsystem identifier (PGMTYPE)

   Program Name             Name of the program being
                            executed

   System ID                System Identifier

   Program Count            Total number of executions for
                            a program


   Total CP Processor CPU   Total of all standalone CPU
   Time                     time (Initiator TCB Time,
                            Initiator SRB Time,
                            Hiperspace CPU Time,
                            I/O Interrupt CPU Time,
                            Region Control Task CPU Time,
                            SRB CPU Time) accumulated for
                            the program.

   Non-zIIP Eligible CPU    Total SRB and TCB CPU time
   Time                     without zIIP eligible time.
                            This is the time that was spent
                            by the program executing non-zIIP
                            eligible work.

   zIIP Eligible CPU        Total CPU time the program spent
   Time                     executing zIIP eligible work
                            that could have run on a zIIP
                            processor, but ran on a standard
                            CP. (PGMSUCTM)

   Normalized zIIP CPU      Total CPU time that is spent
   Time                     performing data servicing tasks
                            in a step on a zIIP processor.
                            (PGMSPNTM)


   zIIP Utilization         The percentage of the total zIIP
   Percentage               eligible and zIIP CPU time the
                            program actually executed on a
                            zIIP processor.

  * Could be either Service Class or Report Class depending
    on the report panel selection.

Total for Service Class / Report Class

   The total of all activity for the Service Class or Report
   Class.

Total for Sysplex

   A grand total of all activity for the sysplex.

A sample report is shown in Figure 3-15.

INQUIRY ID:

     SMFLS2

DATA SOURCE:

     BATPGM
     BAT_OE
     BAT_SA
     BAT_ST
     BAT_TS
     BAT_TP

DATA ELEMENTS USED:

     SYSID    - System Identifier
     PGMTYPE  - Job Exec Type (Batch TSO STC APPC OE SAS)
     PGMCOUNT - Program Step Encountered
     PGMHIPTM - Step Hiperspace CPU Time
     PGMISRTM - Step Initiator SRB Time
     PGMIOITM - Step I/O Interrupt CPU Time
     PGMITCTM - Step Initiator TCB Time
     PGMRCTTM - Step Region Control Task CPU Time
     PGMSRBTM - Step SRB CPU Time
     PGMTCBTM - Step TCB CPU Time
     PGMSPNTM - Normalized zIIP CPU Time
     PGMSUCTM - zIIP Eligible CPU Time on a CP
     PROGRAM  - Program Name
     WLMCLASS - Service Class
     WLMRPTCL - Report Class

CALCULATIONS:

     Total CP Processor CPU Time:

        SUM(PGMISRTM,PGMITCTM,PGMSRBTM,
                    PGMTCBTM,PGMHIPTM,PGMRCTTM,
                    PGMIOITM);

     Non-Eligible zIIP CPU Time:

        PGMCPUTM - PGMSUCTM


     zIIP Utilization Percentage:

       PGMSPNTM/SUM(PGMSUCTM,PGMSPNTM) * 100


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 SMFLS2, whose Catalog Group is GENERAL.

  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.)

+----------------------------------------------------------------------+ |------------------ Address Space zIIP CPU Activity Report ----------- | | Command ===>                                                         | |                                                                      | | Composing Inquiry: SMFLS2 - Address Space zIIP CPU Activity          | | Database ===> ________________________________________               | | Cycle(s) ===> __ - __                                                | | Timespan ===> DETAIL (DETAIL only)                                   | | Generate a report by hour                ===> _ (Y/N)                | | Generate a report for each value of Zone ===> _ (Y/N)                | | Data Selection:                                                      | |                                                                      | | Data Selection:                                                      | |                     dd mmm yy   dd mmm yy   dd mmm yy   dd mmm yy    | |   Date Ranges  ===> __ ___ __ - __ ___ __   __ ___ __ - __ ___ __    | |   Hour         ===> __ - __                                          | |   Zone         ===> _ _ _ _ _ _ _ _ _                                | |   Sysid        ===> ____ ____ ____ ____ ____ ____                    | |   Sysplex      ===> _______ _______ ________ _______ ________        | |                                                                      | | Report by Service Class (S) or Report Class (R)       ===> S (S/R)   | | Service/Report Class Name (use '*' last for wildcard) ===> ________  | | Job Name (JOB) (use '*' last for wildcard)            ===> ________  | | Program Name (PROGRAM) (use '*' last for wildcard)    ===> ________  | | Sort by PGMSUCTM (E), PGMSPNTM (N), or ZIIPUTIL (U)   ===> _ (E/N/U) | |  in ascending (A) or descending (D) order             ===> _ (A/D)   | +----------------------------------------------------------------------+


    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.
      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.

    Timespan - Required. Default is DETAIL. DETAIL is the
      only timespan allowed.

    Date - Optional.  No default.
      Up to two date ranges in DD MMM YY format.  The first
      value in each date range is the starting date and the
      last value is the ending date.  The ending date must be
      higher than the starting date.  The date ranges should
      not overlap, but you can specify the higher range
      before the lower range.  An input observation is
      selected if its date value is greater than or equal to
      the starting date and is less than or equal to the
      ending date of any specified date range.

    Hour - Optional.  No default.
      An hour range from 0 to 23.  The first value is the
      starting hour and the last value is the ending hour.
      The ending hour must be higher than the starting hour.
      An input observation is selected if its hour value is
      greater than or equal to the starting hour and is less
      than or equal to the ending hour of the specified hour
      range.


    Zone - Optional.  No default.
      One-character zone value from 1 to 9.  You can specify
      up to nine zone values.  An input observation is
      selected if its zone value is equal to any of the
      specified values.

    SYSID - Optional.  No default.
      1-4 character SYSID value.  You can specify up to six
      SYSIDs.  An input observation is selected if its SYSID
      value is equal to any of the specified values.


    SYSPLEX - Optional.  No default.
      1-8 character SYSPLEX value.  You can specify up to
      five SYSPLEXs.  An input observation is selected if its
      SYSPLEX value is equal to any of the specified values.


   Report by Service Class (S) or Report Class (R) -
      Required.  Default is Service Class (S).  Service class
      or report class to be used as control-break variables.
      Valid entry is (S) for Service Class or (R) for Report
      Class.

    Service/Report Class Name - Optional. Default is all
      service classes or report classes depending on the
      report by variable selected.  1-8 character value
      identifying the name of the service class (WLMCLASS) if
      report by Service Class (S), or 1-8 character value
      identifying the report class (WLMRPTCL) if report by
      Report Class (R).  You can specify an asterisk (*) as
      the last character for wildcard selection.

    Job Name (JOB) - Optional. Default is all jobs.  1-8
      character value identifying the name of the job (JOB).
      You can specify an asterisk (*) as the last character
      for wildcard selection.

    Program Name (PROGRAM) - Optional. Default is all
      Programs.  1-8 character value identifying the name of
      the program (PROGRAM).  You can specify an asterisk (*)
      as the last character for wildcard selection.

    Sort by PGMSUCTM (E), PGMSPNTM (N), or ZIIPUTIL (U) in
    ascending (A) or descending (D) order - Optional.  No
      default. 1 character value identifying the sort order
      of how the report is displayed within each
      service/report class and 1 character value identifying
      if the sort is in ascending or descending order.  The
      report can be displayed in order of zIIP Eligible CPU
      Time on a CP (PGMSUCTM), Normalized zIIP CPU Time
      (PGMSPNTM), or zIIP Utilization Percentage (ZIIPUTIL)
      within each service/report class.

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.


                                                        A d d r e s s   S p a c e   z I I P   C P U   A c t i v i t y   R e p o r t                                                                                                                           Page 001   Report: Detail Level Information     Report Range: 25JULyy:09:14:42 thru 25JULyy:12:50:47   Sysplex Name:  SYSY   zIIP Normalization Factor:   1       Sorted by:  zIIP Eligible CPU Time - Low to High +----------------------------------------------------------------------------------------------------------------------------------+ |  Service Class:  BATJBWLM                                                                                                        | |                                                                                                                                  | |                                                            |----------------- CP ----------------|   |-- zIIP --|                | |                                                                                                                                  | |                                                             Total CP      Non-zIIP        zIIP       Normalized        zIIP      | |    Job        Address      Program    System    Program     Processor     Eligible      Eligible        zIIP       Utilization   | |    Name      Space Type      Name       ID       Count      CPU Time      CPU Time      CPU Time       CPU Time     Percentage   | |  --------   ------------   --------   ------   ---------   -----------   -----------   -----------   -----------   -----------   | |  SJRLA09R   Batch          IKJEFT1B   SYS2             1    0:02:51.02    0:02:51.02    0:00:00.00    0:00:00.39       100.00%   | |  SJRLA09R   Batch          PRMINCR    SYS2             1    0:00:00.31    0:00:00.31    0:00:00.00    0:00:01.18       100.00%   | |  ONXAP03R   Batch          IEFBR14    SYS2             3    0:00:03.76    0:00:03.76    0:00:00.00    0:00:01.55       100.00%   | |  ONXAP03R   Batch          IKJEFT01   SYS2             8    0:00:10.01    0:00:10.01    0:00:00.00    0:00:03.75       100.00%   | |  ONXAP03R   Batch          IKJEFT1A   SYS2             2    0:00:02.20    0:00:02.20    0:00:00.00    0:00:01.04       100.00%   | |  ONXAP03R   Batch          IKJEFT1B   SYS2             1    0:02:51.02    0:02:51.02    0:00:00.00    0:00:00.82       100.00%   | |  ONXAP03R   Batch          PRMINCR    SYS2             1    0:00:01.04    0:00:01.04    0:00:00.00    0:00:00.37       100.00%   | |  ONXAP03R   Batch          DSNUTILB   SYS2             4    0:00:06.54    0:00:05.17    0:00:01.37    0:00:01.94        58.61%   | |  SJRLA09R   Batch          IKJEFT1A   SYS2             2    0:00:06.76    0:00:04.76    0:00:02.00    0:00:02.45        55.06%   | |  SJRLA09R   Batch          IKJEFT01   SYS2             8    0:00:14.15    0:00:11.85    0:00:02.30    0:00:08.83        79.34%   | |  SJRLA09R   Batch          DSNUTILB   SYS2             4    0:00:06.98    0:00:03.91    0:00:03.07    0:00:04.25        58.06%   | |  SJRLA09R   Batch          IEFBR14    SYS2             3    0:00:15.55    0:00:09.15    0:00:06.40    0:00:02.26        26.10%   | |                                                =========   ===========   ===========   ===========   ===========   ===========   | |                                                                                                                                  | |  Totals                                               38    0:06:49.34    0:06:34.20    0:00:15.14    0:00:28.83        65.57%   | +----------------------------------------------------------------------------------------------------------------------------------+ |                                                                                                                                  | |                                                                                                                                  | |  Sysplex Totals                                       38    0:06:49.34    0:06:34.20    0:00:15.14    0:00:28.83        65.57%   | +----------------------------------------------------------------------------------------------------------------------------------+


Figure 3-15.  Address Space zIIP CPU Activity Report