Run List HDB report

Select the HDB for reporting. The run-time prompt panel is displayed. This is an example of a request for a List HDB report.
Figure 1. Run List HDB report
  File  Options  Help                                        
--------------------------------------------------------------------- 
                     Run LIST HDB Report - CICSDAY            
Command ===> ________________________________________________________ 
                                                                      
Specify Report request options then press Enter to continue submit.   
                                                                      
Report Format:                          ------ Report Interval ------ 
 Report Form  . . ________  +                YYYY/MM/DD  HH:MM:SS.TH  
                                        From 2010/04/06  ___________  
                                        To   2010/04/07  ___________  
 Reporting Options:            
  Precision . . . . 4  (4-6)   
  Alert Severity    ________  +

Enter "/" to select option                                            
/  Edit JCL before submit                          
                                                                        
HDB contains data from 2010/04/07 09:38 to 2010/04/07 09:44.            
                                                                        
 F1=Help     F3=Exit     F4=Prompt   F6=Resize  F10=Actions F12=Cancel

This panel is displayed before CICS PA generates the JCL to run the report and shows the time period spanned by the data in the HDB.

Optionally, specify the following run-time options:
Report Form
The name of a Report Form to be used to tailor the format and content of the HDB report. The Report Form must be a compatible type to the HDB. For a List HDB, either a LIST or LISTX Report Form. To select the name from a list of compatible Report Forms, press Prompt (F4).

CICS PA JCL generation translates the Report Form specification into the FIELDS operand.

If a Report Form is not specified, a report showing all fields in the HDB is produced.

Precision
The precision of numeric fields. Numeric fields can be formatted to either 4, 5, or 6 decimal places. The default is 4.
  • 4 decimal places is 0.0001 precision
  • 5 decimal places is 0.00001 precision
  • 6 decimal places is 0.000001 microsecond precision

This option generates the PRECISION(n) global operand.

Alert Severity
The minimum severity level for reporting or extracts:
CRITICAL
Only transactions with critical alerts are reported, according to the CRITICAL threshold values specified in the Performance Alert Definition. This option only applies to the List report and extract.
WARNING
Only transactions with critical and warning alerts are reported, according to the CRITICAL and WARNING threshold values specified in the Performance Alert Definition. This option only applies to the List report and extract.
INFO
Only transactions with Critical, Warning or Informational alerts are reported, according to the CRITICAL, WARNING, and INFO threshold values specified in the Performance Alert Definition. This option only applies to the List report and extract.
ELIGIBLE
Only transactions that are eligible for alert processing are reported. Eligible transactions are those that have field values that match the Resource values defined in the Performance Alert Definition. All eligible transactions are reported regardless of whether they generate an alert.
ALL or blank
All transactions are reported regardless of whether they are eligible or whether they generate an alert.
Report Interval
Specify a date/time range or a time slot (times only) to filter the HDB input data based on the SMF record time stamp. HDB records with a time stamp within the specified From–To 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.

The From–To 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)
Edit JCL before submit
Select with a / to edit the JCL before submit. CICS PA will generate the JCL and display it in an ISPF Edit session. You can review or modify the JCL using the usual ISPF Edit commands and actions, or you can use the CREATE command to save the JCL in an external data set.

Then to submit the job, enter SUBmit in the Edit command line.

If this option is not selected, the generated JCL is not displayed and the job is submitted immediately.

When you have specified your report options, press Enter to continue submit. You are prompted to Press ENTER to proceed with request. This provides a last opportunity to review and change your report request.