Previous Topic: 3.2.10 Daily Batch Users of SUPERZAP

Next Topic: 3.2.12 Address Space zIIP CPU Activity Report

3.2.11 Address Space zAAP CPU Activity Report

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

INTENDED USE:

The report shows how effectively zAAP processors are being
used by address spaces that have programs containing JAVA
code executing under the control of the Java Virtual Machine
(JVM).  This report can also be used to evaluate how much
workload is zAAP eligible, to determine if zAAP processors
would be beneficial in offloading activity to zAAP processor
engines.

REPORT FORMAT:

The Address Space zAAP 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

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

   Sorted by                Sort order of the report within
                            each Service/Report Class:
                            either zAAP Eligible CPU Time,
                            Normalized zAAP CPU Time, or zAAP
                            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-zAAP Eligible CPU    Total SRB and TCB CPU time
   Time                     without zAAP eligible time.
                            This is the time that was spent
                            by the program executing non-zAAP
                            eligible work.

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

   Normalized zAAP CPU      Total CPU time the program spent
   Time                     executing JAVA application code
                            on a zAAP processor. (PGMZPNTM)

   zAAP Utilization         The percentage of the total zAAP
   Percentage               eligible and zAAP CPU time the
                            program actually executed on a
                            zAAP 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-14.

INQUIRY ID:

     SMFLS1

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
     PGMZPNTM - Normalized zAAP CPU Time
     PGMZACTM - zAAP 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 zAAP CPU Time:

        PGMCPUTM - PGMZACTM


     zAAP Utilization Percentage:

       PGMZPNTM/SUM(PGMZACTM,PGMZPNTM) * 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 SMFLS1, 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 zAAP CPU Activity Report ----------- | | Command ===>                                                         | |                                                                      | | Composing Inquiry: SMFLS1 - Address Space zAAP 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:                                                      | |                     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 PGMZACTM (E), PGMZPNTM (N), or ZAAPUTIL (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 PGMZACTM (E), PGMZPNTM (N), or ZAAPUTIL (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 zAAP Eligible CPU
      Time (PGMZACTM), Normalized zAAP CPU Time (PGMZPNTM),
      or zAAP Utilization Percentage (ZAAPUTIL) 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 A A 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: 09JUNyy:13:28:05 thru 16JUNyy:12:00:00   Sysplex Name:  SYSX   zAAP Normalization Factor: 1 +--------------------------------------------------------------------------------------------------------------------------------+ |  Service Class:  HOTBAT                                                                                                        | |                                                                                                                                | |                                                            |----------------- CP ----------------|   |-- zAAP --|              | |                                                                                                                                | |                                                             Total CP      Non-zAAP        zAAP       Normalized        zAAP    | |    Job        Address      Program    System    Program     Processor     Eligible      Eligible        zAAP       Utilization | |    Name      Space Type      Name       ID       Count      CPU Time      CPU Time      CPU Time       CPU Time     Percentage | |  --------   ------------   --------   ------   ---------   -----------   -----------   -----------   -----------   ----------- | |  N98YYWH3   Batch          SADGCO95   SYS1             4    0:00:32.62    0:00:15.02    0:00:17.60    0:01:10.57        80.04% | |                                                =========   ===========   ===========   ===========   ===========   =========== | |                                                                                                                                | |  Totals                                                4    0:00:32.62    0:00:15.02    0:00:17.60    0:01:10.57        80.04% | +--------------------------------------------------------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------------------------------------------------------+ |  Service Class:  MQHOT                                                                                                         | |                                                                                                                                | |                                                            |----------------- CP ----------------|   |-- zAAP --|              | |                                                                                                                                | |                                                             Total CP      Non-zAAP        zAAP       Normalized        zAAP    | |    Job        Address      Program    System    Program     Processor     Eligible      Eligible        zAAP       Utilization | |    Name      Space Type      Name       ID       Count      CPU Time      CPU Time      CPU Time       CPU Time     Percentage | |  --------   ------------   --------   ------   ---------   -----------   -----------   -----------   -----------   ----------- | |  CS9KZEJ    Started Task   BPXPR001   SYS1             2    0:01:23.74    0:01:22.16    0:00:01.58    0:00:02.96        65.20% | |                                                =========   ===========   ===========   ===========   ===========   =========== | |                                                                                                                                | |  Totals                                                2    0:01:23.74    0:01:22.16    0:00:01.58    0:00:02.96        65.20% | +--------------------------------------------------------------------------------------------------------------------------------+ +--------------------------------------------------------------------------------------------------------------------------------+ |  Service Class:  FASTUSS                                                                                                       | |                                                                                                                                | |                                                            |----------------- CP ----------------|   |-- zAAP --|              | |                                                                                                                                | |                                                             Total CP      Non-zAAP        zAAP       Normalized        zAAP    | |    Job        Address      Program    System    Program     Processor     Eligible      Eligible        zAAP       Utilization | |    Name      Space Type      Name       ID       Count      CPU Time      CPU Time      CPU Time       CPU Time     Percentage | |  --------   ------------   --------   ------   ---------   -----------   -----------   -----------   -----------   ----------- | |  D92MXWG9   USS            BPXPRFD    SYS1             1    0:00:35.18    0:00:34.50    0:00:00.68    0:00:01.70        71.43% | |  D8CMXWG9   USS            BPXPRFD    SYS1             1    0:00:34.80    0:00:34.24    0:00:00.56    0:00:01.33        70.37% | |  D88MXWG9   USS            BPXPRFD    SYS1             1    0:00:35.39    0:00:34.50    0:00:00.89    0:00:02.08        70.03% | |  D83MXWG9   USS            BPXPRFD    SYS1             1    0:00:31.26    0:00:30.67    0:00:00.59    0:00:01.43        70.79% | |  D6GMXWG9   USS            BPXPRFD    SYS5             1    0:00:23.93    0:00:23.91    0:00:00.02    0:00:01.34        98.53% | |                                                =========   ===========   ===========   ===========   ===========   =========== | |                                                                                                                                | |  Totals                                                5    0:02:40.56    0:02:37.82    0:00:02.74    0:00:07.88        74.20% | +--------------------------------------------------------------------------------------------------------------------------------+


Figure 3-14.  Address Space zAAP CPU Activity Report