Start of change

Run Report Form panel

Use the Run Report Form panel to specify report options.

Figure 1. Run Report Form panel (Performance form)
   File  Systems  Options  Help 
 ──────────────────────────────────────────────────────────────────────────────
                           Run Report Form - CPUSPLST
 Command ===>                                                                  

 System Selection:                       Report Output:
  APPLID . . *         +                  DDname . . . . . . . . . LIST0001 
  Image  . .           +                  Print Lines per Page . . 60   (1-255)
  Group  . .           +

 Report Focus:                           ───── Report Interval ───────
  Alert  . . DISP1     +                      YYYY/MM/DD  HH:MM:SS.TH
   Severity  ALL       +                 From                         
                                         To                           

 Summary Options:                        Report Formatting Options:
  Interval  . . 00:05:00  (hh:mm:ss)      Time Zone  . . . . . +8  
  Totals Level  8       (blank or 0-8)    Date Delimiter . . . / 
                                          Time Delimiter . . . : 
                                          Precision  . . . . . 4    (4-6)
 Enter "/" to select option
    Use External Sort
 /  Edit JCL before submit

 Repository  . . : CICSPA.HDB.REPOSTRY                   
Figure 2. Run Report Form panel (Statistics form)
   File  Systems  Options  Help 
 ──────────────────────────────────────────────────────────────────────────────
                           Run Report Form - MVSTCBS
 Command ===>                                                                  

 System Selection:                       Report Output:
  APPLID . . *         +                  DDname . . . . . . . . . SLST0001 
  Image  . .           +                  Print Lines per Page . . 60   (1-255)
  Group  . .           +

 Selection Criteria:                     ───── Report Interval ───────
  Alert  . . TSQUEUE   +                      YYYY/MM/DD  HH:MM:SS.TH
   Severity  ELIGIBLE  +                 From                         
   /  Include Severity column            To                           

  Type . . .    EOD     INT     USS     RRT     REQ 

 Summary Options:                        Report Formatting Options:
  Interval  . . 01:00      (hh:mm)        Time Zone  . . . . . +8  
                                          Date Delimiter . . . / 
                                          Time Delimiter . . . : 
                                          Precision  . . . . . 4    (4-6)
 Enter "/" to select option
    Use External Sort
 /  Edit JCL before submit

 Repository  . . : CICSPA.HDB.REPOSTRY                   
The Run Report Form panel consists of the following fields. Some of the fields apply only to performance forms, statistics forms, or list or summary forms as explained in the following field descriptions.
System Selection
The CICS® APPLID to run the report against. Press Prompt (F4) to select from a list of defined systems, images, and groups. You can specify any combination of APPLID, Image, or Group, that matches a defined system definition.
Report Output
DDname
The DDname for the report output which CICS PA uses when generating the JCL to run the report form.

This option generates the OUTPUT(ddname) operand.

Print Lines per Page
The maximum number of lines to print on each page of the report. The default value is 60.

This option generates the LINECNT(nnn) operand.

Report Focus (performance forms only)
Alert
The name of a performance alert definition to use for a list or summary report form.

This option generates the ALERTDEF(defname) operand.

Severity
Determines the minimum severity level to be reported and the type of transactions reported. Severity is used in performance list and performance summary report forms.
CRITICAL
Only critical transactions are reported.
WARNING
Only critical and warning transactions are reported.
INFO
All alerts are reported: critical, warning and informational transactions.
ELIGIBLE
Only eligible transactions are processed and reported. Eligible transactions are those that have resource values that match resource values specified in the alert definition.

This option provides the means to filter out transactions that would never generate an alert because their resource values do not match resource values specified in the alert definition.

ALL or blank
All transactions are reported regardless of whether they are eligible or whether they generate an alert. This is the default value.
Note: For a summary report form, if you enter a severity of CRITICAL, WARNING, or INFO, this operand is set to SEVERITY(ALL) in the generated JCL. Specifying a minimum severity in a summary report would make the report show zero values in lower severity report columns. The zero values might be misinterpreted to mean that no alerts were generated at the lower level of severity.
Selection Criteria (statistics forms only)
Alert
The name of a statistics alert definition that contains the conditions used to select records.

This option generates the STALTDEF(defname) operand.

Severity
Determines the minimum severity level to be reported and the type of transactions reported. Severity is used in statistics list report forms, but not in statistics summary report forms.
CRITICAL
Only critical transactions are reported.
WARNING
Only critical and warning transactions are reported.
INFO
All alerts are reported: critical, warning and informational transactions.
ELIGIBLE
Only eligible transactions are processed and reported. Eligible transactions are those that have resource values that match resource values specified in the alert definition.

This option provides the means to filter out transactions that would never generate an alert because their resource values do not match resource values specified in the alert definition.

ALL or blank
All transactions are reported regardless of whether they are eligible or whether they generate an alert. This is the default value.
Include Severity column
This option is used to insert a Sev column in a statistics list report, showing the highest severity encountered for each record. This option has no effect for statistics summary report forms.
Type
To limit the types of CICS statistics intervals that CICS PA includes in the report, enter / next to the types you are interested in:
EOD
End-of-day
INT
Interval
USS
Unsolicited
RRT
Requested reset
REQ
Requested

Selecting none of the types is the same as selecting all types.

This option generates the TYPE operand.

Report Interval
This is used to specify a date/time range or a time slot (times only) to filter the SMF input data based on the time stamp of each SMF record.

From and To together specify the report interval. Date is either a calendar date in your preferred format or a relative date. Time is a time-of-day.

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 From and To 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.

Summary Options (performance forms)
Interval
The time interval applies when you want to summarize transaction activity over time. It is used when you specify a summary report form that has any of the key fields OSTART, START, or STOP included. When reporting, CICS PA accumulates the data for each interval in the report period and writes a report line for each.

Specify a value in the range 00:00:01 (1 second) to 24:00:00 (24 hours). The default is 00:01:00 (1 minute).

A time interval of less than one hour must fit evenly into the hour. CICS PA will round it down to the nearest interval that aligns to the hour. For example, 1.35 is reduced to 00:01:30 minutes which will produce 40 interval report lines for each hour of data.

A time interval of more than one hour must fit evenly into the day. CICS PA will round it down to the nearest interval that aligns to the day. For example, 10.30.23 is reduced to 08:00:00 hours which will produce 3 interval report lines for each day of data.

Minutes take precedence for an abbreviated entry. For example:
1
becomes 00:01:00
1.1
becomes 00:01:00 (rounded down from 00:01:01)
1.1.1
becomes 01:00:00 (rounded down from 01:01:01)

This option generates the INTERVAL(hh:mm:ss) operand.

Totals Level
Leave blank if you do not want to include total lines in the report. This generates the NOTOTALS operand.

Specify a number between 1 and 8 to accumulate subtotals for up to 8 sort fields, to print the subtotals when the sort field changes, and to print a grand total at the end of the report. This generates the TOTALS(n) operand where n is a value between 1 and 8. The default value is 8.

Specify 0 for no subtotals, and to print only the grand total. This generates the TOTALS(0) operand.

Summary Options (statistics forms)
Interval
The time interval applies when you want to summarize statistics activity over time. It is used when you specify a summary report form that has the key field COLLECTTIME included. When reporting, CICS PA accumulates the data for each interval in the report period and writes a report line for each.

The format of the field is hh:mm|day of week|MONTH. To specify a day of the week, enter the name of the day, such as MONDAY, or WEDNESDAY.

A time interval of more than one hour must fit evenly into the day. CICS PA will round it down to the nearest interval that aligns to the day. For example, 10.30 is reduced to 08:00 hours which will produce 3 interval report lines for each day of data.

This option generates the INTERVAL(hh:mm|day of week|MONTH) operand.

Report Formatting Options (performance forms only)
Time Zone
This provides a way to override your local CPU time zone setting and convert CMF, DB2®, MQ, and System Logger clock fields to a different time zone. It is only useful if the data you are reporting was generated by a system running with a different time zone.

Specify the time zone as an integer from -12 to +12 to represent the number of hours that local time is west or east of GMT. For example, specify -5 for New York, 10 for Sydney. CICS PA will then convert GMT STCK values to the required local time for all record types.

Date Delimiter
The separator character for the dates in reports and extracts. Any character or a space can be specified. The default value is a slash (⁄).
CICS PA JCL generation translates this option to:
FORMAT(time-delimiter,date-delimiter)
Time Delimiter
The separator character for the time-of-day in reports and extracts. Any character or a space can be specified. The default value is a colon (:).
CICS PA JCL generation translates this option to:
FORMAT(time-delimiter,date-delimiter)
Precision
The precision of numeric fields, and of time stamp fields that specify the TIMEP format. Numeric fields can be formatted to either 4, 5, or 6 decimal places. The default value is 4.
  • 4 decimal places is 0.0001 precision
  • 5 decimal places is 0.00001 precision
  • 6 decimal places is 0.000001 (microsecond) precision

For details on the TIMEP format, see Suboperands for Time Stamp fields.

This option generates the PRECISION(n) global operand.

Use External Sort

Select / to use an external sort utility to process records for the List Extended, Performance Summary, or Statistics Summary report forms. This option generates the EXTERNAL(ddname) operand, which provides the DDname of the work data set used by the external sort utility. CICS PA assigns an external work file from a pool of external work files with default DDnames in the format CPAXWnnn where nnn is a sequential number 001-999 to uniquely identify the work file.

You should use an external sort when processing records that would generate a very large number of unique key values; otherwise an internal sort is used.

Edit JCL before submit
Select / to edit the JCL before you submit the job. CICS PA generates the JCL and displays 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.

Repository
The data set name of the repository that contains the alert definitions.
End of change