The Run Report Set panel is always displayed after
RUN, SUB or
JCL is
requested but before JCL generation commences. This prompts you for
Report Set submission options which allow you to:
- Specify System Selection
- Filter input records based on their SMF time stamp
- Nominate the remedial action you want CICS PA to take
if there are missing files for JCL generation
Figure 1. Run Report Set: setting run-time options File Systems Options Help
-------------------------------------------------------------------------------
Run Report Set REPORT1
Command ===> __________________________________________________________________
Specify run Report Set submission 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
Before
CICS PA generates
the JCL, you are prompted to supply the following run-time options:
- The system(s) to be reported. CICS PA allows
you to specify System Selection twice; in the Report Set and here
at run time. An Override System Selection option is provided to determine
which specification will take precedence in the event of both being
specified.
- When the override option is not selected, the run-time
System Selection overrides the Report Set Global options only. It
does not override any System Selections specified in the individual
reports within the Report Set.
- When the override option is selected, the run-time
System Selection overrides all System Selections in the Report Set
(Global Options and individual reports).
- The date and time range of the SMF data that you wish to process.
If not specified, CICS PA processes
the entire SMF File(s). Note that CICS PA always
honors any time ranges specified in your Report Selection Criteria,
regardless of this setting.
- 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 the JCL before submission.
You can choose to use either Personal or Shared System Definitions
to select the SMF input data sets. Use
Systems in the action
bar to switch between Personal and Shared System Definitions.
Figure 2. Systems action bar: Use Personal
or Shared System Definitions 1. Specify Personal System Definitions...
2. Specify Shared System Definitions...
3. Use Personal System Definitions
*. Use Shared System Definitions
The fields on the Run Report Set panel are:
- System Selection
- System Selection on this panel overrides the global System Selection
and optionally the report-level specification. By specifying your
systems here, CICS PA can
proceed with JCL generation without you having to re-edit the Report
Set.
Use System Selection to identify the systems you want this
Report Set to analyze. They must be defined in System Definitions
with the SMF files you want CICS PA to use
for reporting. You can type in the system IDs, or select them from
a list by placing the cursor on the field and pressing Prompt (F4).
To edit your System Definitions, link directly there by selecting Systems in
the action bar, then on exit you are returned back here.
You
can specify four types of systems:
- CICS® APPLID: The CICS Generic APPLIDs you want reported. Specify
either:
- A unique APPLID.
- An APPLID for a particular MVS™ Image.
This identifies a particular CICS system
when there are multiple CICS systems
with the same APPLID.
- An MVS Image. CICS PA will
report on all APPLIDs running on this Image using the SMF files defined
for the Image.
- An APPLID and Image combination plus a Group. This is useful for
uniquely identifying CICS systems
when there are multiple systems of the same name defined.
- A Group alone. CICS PA will
report on all APPLID and Image combinations in the Group to produce
a single consolidated report. For example, for transaction grouping,
or for systems that connect via IRC/MRO, ISC/APPC, or
IPIC.
CICS PA generates
the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands,
and corresponding //SMFINnnn DD statements.
- DB2® SSID: The DB2 Subsystem IDs. This is only
used by the DB2 Report and Record
Selection Extract. If the CICS APPLID
Group contains the DB2 SSIDs,
then it can be omitted.
CICS PA generates
the SSID(ssid1,ssid2,ssid3,...) operands for the DB2 or RECSEL commands and the DD
statements for the associated files.
- MQ SSID: The MQ Subsystem IDs. This is only
used by the WebSphere® MQ
Report and Record Selection Extract.
CICS PA generates
the SSID(ssid1,ssid2,ssid3,...) operands for the
MQ or RECSEL commands and the DD statements for the associated files.
- Logger: The MVS System
Logger. This is only used by the System Logger Report, System
Logger Extract, and Record Selection Extract. If the CICS APPLID Group contains the
System Loggers, then it can be omitted.
CICS PA generates
the DD statements for the associated files.
For more information, see System selection.
- Override System Selections specified in Report Set
- This specifies which System Selection specification will take
precedence in the event that you have specified System Selection twice;
both here at run time and in the Report Set.
- When the override option is not selected, the run-time
System Selection overrides the Report Set Global options only. It
does not override any System Selections specified in the individual
reports within the Report Set.
- When the override option is selected, the run-time
System Selection overrides all System Selections in the Report Set
(Global Options and individual reports).
- Start Date/Time, Stop Date/Time
- Specify a date/time range or a time slot (times only) to
filter the SMF input data based on the SMF record time stamp. SMF
records with a time stamp within the specified Start/Stop interval
are processed by CICS PA, otherwise
they are ignored.
Note: - Do not confuse this with the Selection Criteria From/To report
intervals which apply to transaction start and stop times.
- For the DB2 Report, specify
a Stop Time that is at least 5 minutes outside the required time (From/To
report interval) if protected threads are in use.
The Start/Stop date and time fields are all optional.
They are blank initially (for no filtering), but thereafter display
the reporting period that was previously saved.
Date is
either a calendar date in your preferred format or a relative date. Time is
a time-of-day. (The same edit rules apply as for the Selection Criteria
Report Interval.)
Relative dates are specified as 0, -1, -2,...
to signify a date relative to the current date. 0 represents today,
-1 yesterday, -2 two days ago, and so on. If both Start and Stop
dates are specified, they must be in the same format.
For a time slot, both times must be present with no dates
to signify the same time slot every day. The times can span midnight.
The
specified date/time range is included in the generated JCL under the
//SYSIN
DD statement:
CICSPA SMFSTART(-nn|yyyy/mm/dd,hh:mm:ss.th),
SMFSTOP(-nn|yyyy/mm/dd,hh:mm:ss.th)
- Missing SMF Files Option
- This option allows you to control what CICS PA does when it strikes a problem with
JCL generation due to Systems defined without SMF Files specified.
Select one of the following actions:
- Issue error message. CICS PA will
abort JCL generation and report the error(s) in a window titled Report
Set JCL Generation Failure. This will allow you to link to System
Definitions and correct your file specifications. See Figure 1 for an example of
this error panel.
- Leave DSN unresolved in JCL. CICS PA will
proceed with JCL generation creating DD statements with DSN=<unresolved> where
the files are not known. Regardless of your JCL or SUB request, the
JCL is edited to allow you to specify the DSNs before submission.
- Disregard offending reports. CICS PA will
proceed with JCL generation. Only reports whose Systems have files
specified are included. All other reports are ignored. If there are
no error-free reports, then a Report Set JCL Generation Failure error
message is issued.
- Edit JCL before submit
- Enter / to edit the JCL with command input before submitting
the report request. This is the default if you used the JCL command
to run the Report Set.
Editing JCL before submit will enable you
to save the JCL in an external data set for automated job scheduling
or ad hoc report requests.
If not selected, the JCL is
generated and the job is submitted immediately. This is the default
if you used the SUBmit command to run the Report Set.
If
you used the RUN command to run the Report Set, the default
setting is what you previously specified.
When the specification is complete, press Enter to proceed.