Set up a Batch Report Definition

Generating Batch Reports › Set up a Batch Report Definition

Set up a Batch Report Definition

You can use the Batch Report panel for a job at any time. The default values for batch reports can be set globally (see the Installation Guide). Global defaults can be changed for each user through the Profile Parameters panel.

From the Monitor Definition panel, type B next to the profile name of the job for which you want to generate batch reports.

Press Enter.

The Batch Report panel displays.

CA MAT ------------------------ Batch Report -----------------------------
                                                            Profile: TUNCIC
                                                                    More: 
  Output Data Set Options  (scroll down for allocation parameters)     
                                                                           
 Report Dataset Name  ===>                                                
                           (Blank for SYSOUT, Dataset name, or .MONDSN)  
    CSV Dataset Name  ===> 'MATUSER.TUNCIC.CSV'                          
                           (Blank for default, .TEMP or .MONDSN)         
                                                                           
  Job Cards    (scroll down for JES Parameters)                          
  ==> //JOBNAME  JOB (ACCT),'TUNBATCH',CLASS=Q,                       
  ==> //         MSGLEVEL=1,MSGCLASS=X                                     
  ==> //*                                                                  
  ==> //*TUNJCL JCLLIB ORDER=CAMAT.V85.UTRSAMP                       
                                                                           
  Report Title  ===>                                                       
                                                                           
  Report Thresholds (Minimum percentages for Summary and detail reports)
    Active Threshold   ===> 5    (CPU activity for Summary and Delay Details)
    Wait Threshold     ===> 10   (Wait activity for Summary and Delay Details)
    Detail Threshold   ===> 1   (Total activity for Summary and Detail reports)
    Transact Threshold  ===> 10   (Transaction activity for Summary report)
                                                                           
  Reporting options                                                       
    Analysis Mode     ===> NORMAL         Analysis Summary  ===> Y      
    Monitor History   ===> Y              DelayView         ===> Y       
    CodeView          ===> Y              DataView          ===> Y       
    TaskView          ===> Y              TranView          ===> Y       
    ModView           ===> Y              PoolView          ===> Y       
    USSView           ===> Y                                              
                                                                           
  Subsystem Details
    DB2View           ===> Y              IMS Transactions  ===> Y
    JVM Information   ===> Y              WebSphere         ===> Y
                                                                         
  Options for DelayView                                                 
    Delay details     ===> ON

Options for CodeView
    Threshold         ===> 1               CodeView mode
    All or top 5      ===> Y               Csect   ===> Y
    Histogram Csect 1 ===>                 Module  ===> N
    Histogram Csect 2 ===>                 Pseudo  ===> N
    Histogram Csect 3 ===>                 4GL     ===> Y
    Histogram Csect 4 ===>

Options for DataView
    Linklist          ===> N     DB2 Code Detail   ===> Y

  Options for TranView
    Code Detail       ===> Y              Delay Detail      ===> N
    Data Detail       ===> ALL
    Transaction 1     ===> *              Transaction 2     ===>
    Transaction 3     ===>                Transaction 4     ===>

  Options for TaskView
    Task  1           ===> *              Task 2            ===>
    Task  3           ===>                Task 4            ===>

  Report Scope
    Report Detail     ===> Y    (Y for full report, N to omit detail 
eports)
    Field Detail      ===> Y    (Y for full report, N to omit trivial 
ields)

  JES Parameters
    Lines per page    ===> 66             Sysout class      ===> *
    Column width      ===> 132            Sysout form       ===>
    JES writer-name   ===>
    Destination       ===>

 Dataset Allocation Parameters  (for report datasets and CSV files)     
     Tracks: Primary  ===> 15             Secondary         ===> 15     
                                                                           
       Volume Serial  ===>           or   Storage Class     ===>        
                Unit  ===> SYSALLDA       Data Class        ===>        
                                          Management Class  ===>
 Scroll UP or DOWN for more options. Enter SUBmit to submit a batch job, EDIt
 to edit the batch job before submitting, press END to exit and save changes,
 or enter CANCEL to exit without saving.

Specify the report title, report format, output destination, and the reports that you want to include.

The fields in the Report Definition panel are described next.

Output Data Set Options

Save the output file for the Batch Reports in CSV format.

Job Cards

Modify the default ISPF job card as needed.

Note that you can use the JCL ORDER statement to specify the library from which the batch programs are fetched, as shown in the panel Bach Report panel: top portion.

Report Title

Specify a unique title to appear at the top of each page of the report.

Report Dataset Name

Specify a data set name to receive the generated batch report.

Leave this field blank to write the report to SYSOUT.

Specify .MONDSN to use the data set name of the monitor file. A .BAT node will be appended to the monitor file name to create the file name. Some truncation may occur if the resulting name is longer than 44 characters. If the data set is not found, it will be created.

Reporting Thresholds

Active Threshold

Specify the minimum percentage of CPU activity for Summary and Detail reports (default is 5).

Wait Threshold

Specify the minimum percentage of wait activity for Summary and Detail reports (default is 10).

Detail Threshold

Specify the minimum percentage of combined CPU and wait activity for Summary and Detail reports (default is 1).

Transact Threshold

Specify the minimum percentage of transaction activity for Summary reports (default is 10).

Reporting Options

Analysis Mode

Specify one of the following values:

NORMAL: Information that is not directly related to the target application is eliminated; data is reported as follows:
- Samples related to delay categories such as Waiting for CPU, LPAR delay, and Swap delay are omitted from reports.
- DelayView, TimeView, DataView, and ModView show all relevant delays for the application. All relevant samples, both active and wait, are reported.
- CodeView and related histograms report only active samples to emphasize the most CPU-intensive portions of the program code. Wait samples, which can mask this activity, are not included.
ALL: The results of the analysis reflect all samples that were obtained during the monitor period.
ACTIVE: The results of the analysis reflect only those samples in which the program was actively using CPU.
WAIT: The results of the analysis reflect only those samples in which the program was in a wait state.

Analysis Summary

Specify Y (default) to include the Analysis Summary report in the Batch Reports.

This report shows the highest delay causes, and therefore the programs and resources that might best benefit from tuning, in one report.

Monitor History

Specify Y (default) to generate the batch history report.

Specify N for no report.

DelayView

Specify Y (default) to generate a DelayView report.

Specify N for no DelayView report.

CodeView

Specify Y (default) to generate a CodeView report.

Specify N for no CodeView report.

DataView

Specify Y (default) to generate a DataView report.

Specify N for no DataView report.

TaskView

Specify Y (default) to generate a TaskView report.

Specify N for no TaskView report.

TranView

Specify Y to generate a TranView report.

Specify N (default) for no TranView report.

ModView

Specify Y (default) to generate a ModView report.

Specify N for no ModView report.

PoolView

Specify Y to generate a PoolView report.

Specify N (default) for no PoolView report.

USSView

Specify Y to generate a USSView report.

Specify N (default) for no USSView report.

Subsystem Details

DB2View

Specify Y to generate a DB2® Subsystem report.

Specify N for no DB2 Subsystem report.

IMS Transactions

Specify Y to generate a IMS Subsystem report.

Specify N for no IMS Subsystem report.

JVM Information

Specify Y to generate a JVM Subsystem report.

Specify N for no JVM Subsystem report.

WebSphere

Specify Y to generate a WebSphere Application Server report.

Specify N for no WebSphere Application Server report.

Options for DelayView

Detail

Specify ON if you want the DelayView report to contain detailed information about the delay causes.

Specify OFF if you want the DelayView report to contain only high-level information about delay causes (default is ON).

Options for CodeView

Threshold

Specify the threshold value (0 to100) for CodeView.

Modules or CSECTs that have a total activity percentage below this value are not included in the batch CodeView report (CSECT and Module modes only). The sum total of all activity below the threshold is included as Module/CSECT **N/A**. Specify a threshold of 0 (zero) to include all modules or CSECTs. The default is 1 (1%).

All-User-Top 5

You can specify one of the following choices:

Specify the threshold value (0 to100) for CodeView.
Modules or CSECTs that have a total activity percentage below this value are not included in the batch CodeView report (CSECT and Module modes only). The sum total of all activity below the threshold is included as Module/CSECTs **N/A**. Specify a threshold of 0 (zero) to include all modules or CSECTs. The default is 1 (1%).
Specify Y to create histograms for the five CSECTs showing the greatest activity or delay in CodeView.
CSECTs with total activity below the CodeView Detail Threshold are omitted.
Specify A to create histograms for all CSECTs reported by CodeView.
Specify U to create histograms for User CSECTs only (only those CSECTs which do NOT have an associated base-level CSECT description).
Specify N to suppress generation of histograms.
CSECT histograms are produced in order of descending activity. Histograms are not produced for CSECT that show no activity.

CodeView mode

Specify the mode for CodeView batch reports.

Possible modes are CSECT, MODULE, PSEUDO, or 4GL. The default is CSECT. See "Interactive analysis option 3 - CodeView" on page 157 for more information.

Histogram CSECT 1- Histogram CSECT 4

Specify up to four CSECT names for which you want to create histograms.

To suppress the generation of histograms for certain classes of CSECTs, you can specify the leading characters of the CSECTs to exclude. In the Options for CodeView section, the four Histogram CSECT fields have been updated to allow the user to exclude CSECTs, as follows:

Enter the NOT character '' (SHIFT+6), followed by the initial characters of the Csect names that you want to exclude.
As an example, IBM® will exclude any CSECTs that begin with IBM (such as IBMRBGK1).
If the 'TOP 5' option is selected, excluded CSECTs will not be counted as part of the five CSECTs.
Do not use any wildcard characters ('*','#). You can use as many characters as needed.
Excluded CSECTS can be specified in the Profile Parameters panel (Option 0), to be used for all new batch reports (existing profiles will need to be updated separately).

Options for DataView

Linklist

Specify Y to include the names of the LINKLIST libraries for your installation as part of the DataView report

Specify N (default) for no LINKLIST information

DB2 Code Detail

Specify Y (default) to generate the DB2 Code Detail report

Specify N for no report

Options for TranView

Code Detail

Specify Y to generate the batch report

Specify N (default) for no report

Delay Detail

Specify Y to generate the batch report

Specify N (default) for no report

Data Detail

Specify the transactions on the TranView panel that will have a link to the DataView Detail panel, if data set information is available for that transaction

Specify Y (yes) for the top five transactions, N for none, or ALL for all transactions that have data set information.

Transaction 1 – Transaction 4

Select up to four specific transactions to appear in the following reports:

CodeView (including histograms)
DelayView
TaskView
TranView

This field supports the use of the * wildcard character to match multiple characters and the + wildcard character to match any single character. If you want all transactions to appear, specify an asterisk (*) in this field. Asterisk is the default.

Options for TaskView

Task 1 – Task 4

Select up to four specific tasks to appear in the following reports:

CodeView (including histograms)
DelayView
TaskView
TranView

This field supports the use of the * wildcard character to match multiple characters and the + wildcard character to match any single character. If you want all tasks to appear, specify an asterisk (*) in this field. Asterisk is the default.

Options for Report Scope

Report Detail

Specify the overall level of detail that is included in the Batch Report

Specify Y to include all reports. To omit the Delay Distribution, Delay Detail, and Code Detail reports, specify N. The default is Y.

Field Detail

Specify the field-level of detail that is included in the DataView and ModView reports

Specify Y to include all fields. To omit the noncritical fields, specify N. The default is Y.

JES Parameters

Lines per page

Specify the number of lines on each page of the batch report (the default is 66).

Sysout class

Specify an output destination for the batch reports (default is an asterisk (*))

The asterisk (*) ensures that CA Mainframe Application Tuner generated reports use the same SYSOUT class as the job card.

Column width

Specify the width of the batch reports.

The default is to 132.

Sysout form

Specify a one- to four-character form name for the destination to which the report is written.

JES writer-name

Specify a program name as part of the SYSOUT definition that JES uses to process the data set.

Some SYSOUT management products use the writer-name as routing information instead of using an actual program name.

Destination

Specify the one- to eight-character node name of the JES destination.

In addition, you can specify a one- to eight-character user ID to which the SYSOUT report is written. If you specify a user ID, it must follow the node name and must be separated from the node name with a period.

The following panel shows the Analysis Summary Report that is created by CA Mainframe Application Tuner when you specify Y on the Batch Report panel.

*-------------------------------->  SUMMARY  <---------------------------------*
TRANSACTION INFORMATION *******************************************************
  (TRANSACTIONS ACCOUNTING FOR OVER 10.00% OF ACTIVITY)

  TRANSACTION #TRANS TOT CPU  AVG CPU  ACTV% WAIT% TOTL% VISUAL
  ----------- ------ -------- -------- ----- ----- ----- ----------
        Q904    4361 33.60984  0.00771 37.06 30.06 67.12 =====>
        M710     544  8.92706  0.01641  2.71 14.58 17.30 >

DB2 DELAYS ********************************************************************
 (REPRESENTING 59.33% OF TOTAL DELAYS)

  COLLECTION PACKAGE  STMT   TYPE      ACTV%  WAIT%  TOTL%  VISUAL
  ---------- -------- ------ --------  ------ ------ ------ ----------
    BWOQACO  QX2CBWI1 5731   SELECT     16.43   0.60  17.02 >
    BWOBGCO  BG2C7060 4928   FETCH       3.21   0.03   3.25
    BWOBGCO  BG2CB401 2909   SELECT      0.03   3.19   3.22
    BWOBGCO  BG2CB401 3322   SELECT      0.00   3.21   3.21
    BWOMCCO  MC7C8500 15688  SELECT      0.00   3.05   3.05
    BWOBGCO  BG7C5730 20305  INSERT      0.04   2.28   2.32
    BWOMCCO  MC7C8000 10789  UPDATE      0.00   1.80   1.80
    BWOBGCO  BG7C5730 21287  INSERT      0.01   1.11   1.12
    BWOBGCO  BG2CB401 3047   SELECT      0.00   1.11   1.11

PROGRAM ACTIVE DELAYS *********************************************************
  (REPRESENTING 23.10% OF TOTAL DELAYS)

  MODULE   CSECT     OFFSET   STMT   TOTAL%   CSECT DESCRIPTION
  -------- --------  -------- ------ -------  -----------------
  DFHD2EX3 DFHD2EX3  000003B8         11.37   CICS-DB2 SUBTASK PROGRAM
  DFHSIP   DFHDSDS3  00000940          8.95   DS DOMAIN - MAIN DISPATCH LOOP

IO WAIT DELAYS ****************************************************************
  (REPRESENTING 0.74% OF TOTAL DELAYS)

  MODULE   CSECT     OFFSET   STMT   TOTAL%   CSECT DESCRIPTION
  -------- --------  -------- ------ -------  -----------------
  DFHSIP   DFHDSDS3  000010F6          1.26   DS DOMAIN - MAIN DISPATCH LOOP
**************************** END OF SUMMARY REPORT ****************************

Tell Technical Publications how we can improve this information