Set run-time options
- 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
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
_ 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
- The systems to be reported. CICS PA allows you to specify System Selection twice; in the Report Set and here at run time. The Override System Selection option is provided to determine which specification will take precedence in the event of both being specified.
- Whether to stop reading the SMF file as soon as the first record is encountered that is later than the To date and time, or to process all records through to EOF.
- The date and time range of the SMF data that you want to process. If not specified, CICS PA processes the entire SMF Files. 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.
- 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 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.
- CICS® APPLID: The CICS Generic APPLIDs you want reported. Specify
either:
- 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).
- Read SMF File to EOF
- Select this option to force CICS PA to process all records in the SMF file
through to EOF. Normally CICS PA stops reading
the SMF file as soon as the first record is encountered that is later than the
To time (SMFSTOP). However, if the file is not in ascending time sequence,
reading might end before all records earlier than SMFSTOP have been found.
This option is only effective when the To time is specified. Select it when you want to ensure that all records within the From and To time range are processed but the records are not in ascending time sequence. (For example, if the SMF file has been presorted or merged in some other sequence.)
The Read SMF File to EOF setting in the profile options is added as a READ2EOF operand to JCL built when the input is an SMF file and Report Interval is specified in the RUN panel.
- 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.
Use these fields to specify a time period to filter the input data before processing by all commands in the command input. CICS PA processes only those records with within the specified time period. If not specified, the entire input file is processed.
Processing of start (SMFSTART) and stop (SMFSTOP) times happens as follows:
- Each record is examined at read time to see if it matches the specified time range. This is very early in the record processing cycle and before the records are passed to report processing modules for selection criteria checking.
- SMF record processing commences when a record whose SMF time is ≥ From is encountered.
- SMF record processing terminates when a record whose SMF time is > To is encountered (before EOF).
Start and stop time processing relies on the SMF records being in ascending time sequence. If this is not possible, use one of the following methods to ensure that the generated JCL will process the whole file and does not prematurely terminate.
- If a shared system definition is used, the RUN panels require the Report Interval to be specified for file selection, which also automatically generates the SMFSTART and SMFSTOP operands. To ensure that the whole file is processed and is not prematurely terminated, the READ2EOF operand must be in the batch command. This operand is generated by the setting the Read SMF File to EOF profile option to YES. Alternatively, you can delete the SMFSTART and SMFSTOP operands from the command, which can be more efficient.
- If a personal system definition is used, do not specify Report Interval in the RUN panels. so that the SMFSTART and SMFSTOP operands are not generated. Otherwise you again need to set "Read SMF File to EOF" to YES.
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 date/time range:- Either From or To can be omitted to indicate that the range is
open-ended.
- If From is omitted, it defaults to the first input record
- If To is omitted, it defaults to the end of file.
- If From date is specified with no time, the start of day is assumed.
If To date is specified with no time, the end of day is assumed.
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
- Use this option to control what CICS PA
does when there is a problem with JCL generation due to Systems defined
without SMF Files.
- Issue error message. CICS PA will cancel JCL generation and report errors in a window titled Report Set JCL Generation Failure. This window allows you to link to System Definitions and correct the file specifications. See Figure 1 for an example.
- 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 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.