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:
- 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
+ ___ Performance Graphs 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:
CICS APPLID . . *_______ + Image . . ________ + Group . . ________ +
DB2 SSID . . . ____ + Image . . ________ + Group . . ________ +
MQ SSID . . . ____ + Image . . ________ + Group . . ________ +
Logger . . . . ________ + Image . . ________ + Group . . ________ +
_ Override System Selections specified in Report Set
------ 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 wish 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 V3R2 Report JCL
000003 //CICSPA EXEC PGM=CPAMAIN
000004 //STEPLIB DD DSN=CICSPA.V3R2M0.SCPALINK,DISP=SHR
000005 //CPAHDBRG DD DISP=SHR,
000006 // DSN=CICSPA.HDB.REGISTER
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 HDB Register 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 HDB Register
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 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.
- 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
and review the job output.