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.
- 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.
- 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 + ___ Extracts No ** End of Reports **
- 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
using Personal System Definitions
CICS APPLID . . *_______ + Image . . ________ + Group . . ________ + DB2 SSID . . . ____ + Image . . ________ + Group . . ________ + MQ SSID . . . ____ + Image . . ________ + Group . . ________ + Logger . . . . ________ + Image . . ________ + Group . . ________ + _ Override System Selections specified in Report Set _ Read SMF File to EOF ------ 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:- Which systems are to be reported. Press Prompt (F4) from the APPLID field to select from a list of systems. In our case, select *.
- 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.
- 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.
- Select to edit JCL before submitting the job.
- 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 V5R3 Report JCL 000003 //CICSPA EXEC PGM=CPAMAIN 000004 //STEPLIB DD DSN=CICSPA.V5R3M0.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
PRECISION(4),
000023 LIST(OUTPUT(LIST0001)) 000024 /* ****** **************************** 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 or log streams specified in system definitions.
Note: SMF file ddnames do not need to 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.
PRECISION(n)
The precision to use in the report for numeric fields. Possible values are 4, 5, and 6. The default value is 4.
- PRECISION(4) is 0.0001 precision
- PRECISION(5) is 0.00001 precision
- PRECISION(6) is 0.000001 (microsecond) precision
- 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.
- Make any necessary changes, then enter SUB on the command line to submit the job.
- Exit to return to the Report Set definition. Note that changes to the JCL are not saved.
- Exit again until the Primary Option Menu is displayed.
Use standard ISPF facilities to follow the progress of the job.