
Run Report Form panel
Use the Run Report Form panel to specify report options.
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
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
- 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.
- Either From or To can be omitted to indicate that the range is open-ended.
- 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.
