Running the Report Set

When you have completed specifying all the reports that you want in this Report Set, it is ready to submit for batch processing. Note that it is optional to save the Report Set first as you can select report categories and individual reports for submission independently of the Report Set.

If you returned to the Report Sets list, select Report Set REPORTS1 to display the Report Set menu tree and proceed as follows:
  1. Observe that the Performance List report is now Active (Yes). Also observe that the Performance Reports category and the Global Options are automatically Active (Yes). The Active status identifies which reports in the Report Set are requested.
  2. Now we are ready to run the Report Set. Enter the RUN command on the command line. (Alternative commands are JCL or SUBmit.).

    When you run the Report Set, only active reports within active categories are selected. However, you can temporarily override inactive status by using the RUN line action to additionally select particular reports and categories listed as Active (No).

       File  Systems  Confirm  Options  Help
     ------------------------------------------------------------------------------
     EDIT                      Report Set – REPORTS1
     Command ===> RUN_____________________________________________ Scroll ===> PAGE
     
     Description  . . . . Demonstration Report Set______
     
     Enter "⁄" to select action.
     
     ___          ** Reports **                           Active
          +  ___  Options                                   Yes
          +  ___  Selection Criteria                        No
          -  ___  Performance Reports                       Yes
                  ___  List                                 Yes
                  ___  List Extended                        No
                  ___  Summary                              No
                  ___  Totals                               No
                  ___  Wait Analysis                        No
                  ___  Transaction Profiling                No
                  ___  Cross-System Work                    No
                  ___  Transaction Group                    No
                  ___  BTS                                  No
                  ___  Workload Activity                    No
                  ___  Transaction Tracking List            No
                  ___  Transaction Tracking Summary         No
          +  ___  Exception Reports                         No
          +  ___  Transaction Resource Usage Reports        No
          +  ___  Statistics Reports                        No
          +  ___  Subsystem Reports                         No
          +  ___  System Reports                            No
          +  ___  Performance Graphs                        No
          +  ___  Extracts                                  No
                  ** End of Reports **  
  3. Before CICS PA generates the JCL, the Run Report Set panel intervenes.
       File  Systems  Options  Help
     -------------------------------------------------------------------------------
                                 Run Report Set REPORTS1        
     Command ===> __________________________________________________________________
     
     Specify run options then press Enter to continue submit.
     
     System Selection:
      CICS APPLID . . *_______  +  Image . . ________  +  Group . . ________ +
      DB2 SSID  . . . ____  +      Image . . ________  +  Group . . ________ +
      MQ SSID   . . . ____  +      Image . . ________  +  Group . . ________ +
      Logger  . . . . ________  +  Image . . ________  +  Group . . ________ +
     
      _  Override System Selections specified in Report Set
      Start of change_  Read SMF File to EOFEnd of change
     
                                            ------ Report Interval ----- 
    Missing SMF Files Option:                    YYYY/MM/DD  HH:MM:SS.TH 
    2  1. Issue error message               From __________  ___________ 
       2. Leave DSN unresolved in JCL       To   __________  ___________ 
       3. Disregard offending reports                                   
                                                                       
    Enter "/" to select option                                          
    /  Edit JCL before submit                      
     
      F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
     F12=Cancel
    It prompts you to supply the following run-time options:
    1. Which systems are to be reported. Press Prompt (F4) from the APPLID field to select from a list of systems. In our case, select *.
    2. The date and time range of the SMF data that you want to process. If not specified, CICS PA processes the entire SMF file. Note that any time ranges specified in Selection Criteria in your Report Set are then processed normally within this reduced period of data.
    3. Missing SMF Files Option that specifies the remedial action to be taken if you have not defined SMF files for the systems to be reported.
    4. Select to edit JCL before submitting the job.
  4. Press Enter to generate the JCL. If you selected Edit JCL before submit, the generated JCL is displayed in an ISPF edit session.
       File  Edit  Edit_Settings  Menu  Utilities  Compilers  Test  Help
     -------------------------------------------------------------------------------
     EDIT       xxxx.SPFTEMP1.CNTL                              Columns 00001 00072
     Command ===> SUB_____________________________________________ Scroll ===> PAGE
     ****** ***************************** Top of Data ******************************
     000001 //USERID JOB (ACCOUNT),'NAME'
     000002 //* CICS PA V5R1 Report JCL
     000003 //CICSPA   EXEC PGM=CPAMAIN
     000004 //STEPLIB  DD DSN=CICSPA.V5R1M0.SCPALINK,DISP=SHR  
     000005 //CPAHDBRG DD DISP=SHR,                    
     000006 //            DSN=CICSPA.REPOSTRY
     000007 //SYSPRINT DD SYSOUT=*
     000008 //* SMF Input Files
     000009 //SMFIN001 DD DSN=CICSGSG.CMF.FILE1,
     000010 //            DISP=SHR
     000011 //* Command Input
     000012 //SYSIN DD *
     000013 * Report Set =REPORTS1
     000014 * Description=Demonstration Report Set
     000015 * Reports for System=*
     000017 *             Description=Generic APPLID for getting started
     000018          CICSPA IN(SMFIN001),
     000019                 APPLID(*),
     000020                 LINECNT(60),
     000021                 FORMAT(':','/'),
     000022             LIST(OUTPUT(LIST0001))
     000023 /*
     ****** **************************** Bottom of Data ****************************
    Observe the following JCL statements:
    JOB
    The job statement is derived from the Job Statement Information in your CICS PA Settings profile option (option 0.1 from the primary option menu).
    PGM=CPAMAIN,PARM='parameter list'
    Request CICS PA reporting with optional parameters:
    UPPER
    UPPER translates all report output to upper case. This parameter is generated if you specify YES for Reports in Upper Case in your CICS PA Settings profile options. The default is mixed case (UPPER omitted).
    STEPLIB DD
    This is the library containing the CICS PA modules. It is specified in CICS PA Load Library in the CICS PA Settings profile options.
    CPAHDBRG DD
    This identifies the Repository data set. This is a VSAM KSDS that is the repository for shared information such as historical databases, application groups and shared system definitions. The Repository data set name is specified in your CICS PA Control Data Sets profile option 0.3. It can also be specified when required for historical database, shared systems, statistics, profiling, or resource definitions.
    SYSPRINT DD
    CICS PA message data set. This DD statement defines the file used by CICS PA for its messages and run time information. It must be specified and should be checked for error messages.
    SMFINnnn DD
    One or more DD statements define the SMF data sets to be processed by CICS PA. This ddname corresponds to the INPUT(ddname) or IN(ddname) report operand.

    The CICS PA dialog automatically generates these DD statements based on the CICS® APPLIDs selected for reporting and their associated SMF files Start of changeor log streamsEnd of change specified in system definitions.

    Note: SMF file ddnames need not be prefixed by SMFIN. CICS PA will accept any ddname.
    SYSIN DD
    The CICSPA report command input built from the requested (active) reports and extracts in the Report Set.
    INPUT(ddname)
    The ddname of the corresponding SMF file as specified in the JCL. In this example, the ddname is SMFIN001.
    APPLID(xxxxxxxx)
    The CICS system APPLID specified in the Report Set Run panel. In this example, the APPLID was the non-specific * so the report will include all CICS systems in the SMF file.
    LINECNT(nnn)
    The number of report lines per page specified in the Report Set global option Print Lines per Page. The default is 60.
    FORMAT(time,date)
    The delimiters to use when formatting the time and date in reports and extracts. The values are specified in the Report Set global options Time Delimiter and Date Delimiter. The defaults are the colon (:) and forward slash (/) respectively.
    LIST(...)
    Requested (active) report in the Report Set. In this example, the Performance List report.
    OUTPUT(ddname)
    The ddname that identifies the report output file. It is the Report Output DDname specified on the report panel. In this example, the ddname is LIST0001.

    Note that the corresponding DD statement for the report output file need not be specified in the JCL. CICS PA will dynamically allocate it when the report is generated.

  5. Make any necessary changes, then enter SUB on the command line to submit the job.
  6. Exit to return to the Report Set definition. Note that changes to the JCL are not saved.
  7. Exit again until the Primary Option Menu is displayed.

Use standard ISPF facilities to follow the progress of the job.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//cpags486.htm