Tutorial: Submitting a batch report

This tutorial shows you how to create a batch report for a session.

Before you begin

You must already have created a session and added an SMF file to the session. For details, see Tutorial: Creating a session and browsing a log.

Procedure

  1. On the Transaction Analysis Workbench Primary Option Menu, select option 1 Sessions.
  2. Select the session that you created previously.
    Figure 1. Panel: Session Manager: selecting an existing session
       File  Help 
 ──────────────────────────────────────────────────────────────────────────────
                                Session Manager                 Row 1 to 2 of 2 
 Command ===>                                                  Scroll ===> PAGE

 NEW Register a new Session

 /  Key       Status  Description                                            
    00000001  OPEN    CPU delay in DBCTL
 s  00000002  OPEN    Getting started
 ******************************* Bottom of data ********************************
  3. On the session menu, select option 4 Reporting.

    The Reporting menu is displayed.

  4. Select option 4 SMF.
    This option uses SMF files for input.
    Figure 2. Panel: Reporting menu
       File  Help 
 ──────────────────────────────────────────────────────────────────────────
                                 Reporting 
 Option ===> 4                                                             

 Select a reporting option then press Enter.                                 

 1  IMS         Transaction and system analysis using IMS PA                 
 2  CICS        Transaction and system analysis using CICS PA                
 3  CICS-DBCTL  Combined CICS and IMS analysis of transactions               
 4  SMF         z/OS and subsystem analysis                                  
 5  DB2         DB2 accounting exception analysis                            
 6  OPERLOG     Sysplex operations log (SYSLOG)
  5. On the Reporting - z/OS and Subsystem Analysis panel, select the Address space accounting report by entering a slash (/) next to it. Do not press Enter yet.
    For this tutorial, we will leave the Report Interval blank to process all of the records in the file that we are about to select, regardless of date.
  6. Select the SMF file:
    1. Select option 2 SMF File.
    2. Tab to the SMF File field.
    3. Press the Prompt function key (F4).
      A pop-up window opens, which lists the SMF files that are associated with the session.
    4. Tab to an SMF file, and then press Enter.
      The window closes. The name of the SMF file that you selected is displayed in the SMF File field.
    Figure 3. Panel: Selecting a report for an SMF file
       File  Help 
 ──────────────────────────────────────────────────────────────────────────────
                    Reporting - z/OS and Subsystem Analysis 
 Command ===>                                                                  
 
 z/OS MVS system analysis:               ───── Report Interval ──────
    CPU, storage and paging                   YYYY-MM-DD  HH.MM.SS.TH
 /  Address space accounting             From                         
    MVS System Logger                    To                           
    DASD data set activity              
 
 Subsystem analysis:
    DB2 thread accounting               
    IBM MQ thread accounting      
    APPC conversations                  
    IMS IRLM long lock                  
 
 Select the z/OS system to report against, or specify an SMF file:
 2  1. System . . .           +
    2. SMF File . . 'CPPX.DEMO.SMF'                               +
  7. Press Enter twice to generate the JCL for the report.
    The JCL is displayed in a Notepad panel.
    Tips:
    • Look at the REPORT command in the in-stream SYSIN data set. The OUTPUT parameter specifies the ddname of the data set in the job output that will contain the report.
    • To generate the STEPLIB DD statement, the dialog uses the value of the Workbench Load Library field from your dialog profile, option 0.1 Workbench Personal Settings. If the Workbench Load Library field is blank, the dialog omits the STEPLIB DD statement, and the FUWBATCH program must be in the standard z/OS® search order, such as the LNKLST concatenation; otherwise, the job will fail.

      If the STEPLIB DD statement is missing, and you want to generate new JCL with this statement:

      1. Press the Cancel function key (F12) to exit the Notepad panel.
      2. Enter PROFILE on the command line of the Reporting - z/OS and Subsystem Analysis panel.

        The Workbench Profile Settings menu opens.

      3. Select option 1 Personal.
      4. In the Workbench Load Library field, enter the fully qualified data set name of the Transaction Analysis Workbench load library (supplied with the default low-level qualifier SFUWLINK), enclosed in single quotes. For example, 'FUW.V1R3M0.SFUWLINK'.
      5. Press the Exit function key (F3) to exit the Workbench Personal Settings panel.
      6. Press the Exit function key (F3) to close the Workbench Profile Settings menu and return to the Reporting - z/OS and Subsystem Analysis panel.
      7. Press Enter twice to generate the JCL.
  8. Submit the job: enter SUB on the command line.
    Figure 4. Panel: Submitting generated JCL
       File  Edit  Edit_Settings  Help 
 ───────────────────────────────────────────────────────────────────────────────
 EDIT                            Notepad                       New task created 
 Command ===> SUB                                              Scroll ===> PAGE

 Description z/OS and subsystem analysis report                               

 ****** ***************************** Top of Data ******************************
 000001 //MIDFUW JOB ,NOTIFY=&SYSUID
 000002 //*
 000003 //FUWBATCH EXEC PGM=FUWBATCH
 000004 //STEPLIB  DD  DSN=PRODUCTS.FUW.SFUWLINK,
 000005 //             DISP=SHR
 000006 //FUWPROBR DD  DSN=MID.FUW.SESSIONS,
 000007 //             DISP=SHR
 000008 //SYSPRINT DD  SYSOUT=*                   Messages
 000009 //JOBSTATS DD  SYSOUT=*                   Address Space accounting
 000010 //SMFIN001 DD  DSN=CPPX.DEMO.SMF,
 000011 //             DISP=SHR
 000012 //SYSIN    DD  *                          Command input
 000013 SESSION=00000002
 000014 REPORT SMF(30)    OUTPUT(JOBSTATS)     /* Address Space accounting
 000015 CODE(SMF,30.)                          /* Include...
 000016 COND PROGRAM EQ 'DFH*'                 /* ...CICS address spaces
 000017 COND PROGRAM EQ 'DFS*'                 /* ...IMS address spaces
 000018 COND PROGRAM EQ 'BPE*'                 /* ...IMS address spaces
 000019 COND PROGRAM EQ 'DSNYASCP'             /* ...DB2 address spaces
 000020 COND PROGRAM EQ 'DXRRLM00'             /* ...IRLM address spaces
 000021 /*
  9. View the job output in the session workflow: return to the session menu, select option 2 Workflow, and then enter ? next to the corresponding task.

Example report

The following figure shows an example report.

Figure 5. Example Address Space Activity report
V1R3M0                                      Transaction Analysis Workbench                                Page   1
                                          SMF Type=30 Address Space Activity

------------Interval-------------   System                         ----------- CPU -----------  EXCPs  ----Storage-----
Start Date/Time      Duration Typ    Name   Jobname  Stepname Comp        TCB        SRB  %CPU  /Sec   <16M  >16M 64bit

2011-02-25 09:45:00  00:14:59 INT  FTS1     DB2PMSTR MASTER   0000   1.188172   0.284325   0.2      1    1M   25M    0M
2011-02-25 09:45:00  00:14:59 INT  FTS1     DB2PDBM1 DBM      0000   0.059287   0.697935   0.1      5    2M  150M    0M

2011-02-25 11:30:01  00:14:58 INT  FTS1     IMSPMPP1 REGION   0000   0.110287   0.003570   0.0      0    0M   11M    0M
2011-02-25 11:30:01  00:14:58 INT  FTS1     IMSPCTL  CONTROL  0000   0.300900   0.068595   0.0      0    2M   21M    0M
2011-02-25 11:30:01  00:14:58 INT  FTS1     IMSPDBRC DBRC     0000          0   0.000255   0.0      0    0M   15M    0M
2011-02-25 11:30:01  00:14:58 INT  FTS1     IMSPDLIS DLISAS   0000   0.028560   0.001147   0.0      0    1M   15M    0M

2011-02-25 11:30:01  00:14:58 INT  FTS1     CICSPAOR CICS     0000  97.986300   1.432845  11.1     21    4M 1369M    0M
⋮