Statistics Alert reports
The Statistics Alert reports process CICS® Transaction Server and CICS Transaction Gateway statistics records.
To request a report, enter line action S against the Alert Statistics Report on the Report Set panel. If reports of this type have been previously specified, the list of Statistics Alert Reports is displayed. Otherwise, the Statistics Alert Reports panel is displayed for you to define your first report of this type.
File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Statistics Alert Reports Row 1 from 1
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----
/ Exc APPLID + Image + Group + Output Alert +
_ CICSP001 MVS1____ ________ STAL0001 IDDS____
********************************* End of list *********************************
This panel displays the list of Statistics Alert Reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).
The options are:
- Exc
- An asterisk (*) in this field indicates that the report is
excluded from report processing.
Use line action X to reverse the Exclude indicator.
- System Selection
- Identifies the CICS APPLIDs
whose data you want to select for processing.
You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.
Specify one of the following:- A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
- An APPLID and an MVS™ Image. This identifies the MVS Image where your CICS system runs.
- An MVS Image. All CICS systems executing on this MVS Image are selected.
- An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
- A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.
CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.
System Selection can also be specified either:- In Global Options. The report-level specification takes precedence over the global.
- At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.
- Output
- CICS PA provides a default Report Output DDname in the format STALnnnn where nnnn is 0001-9999.
- Alert
- The alert definition containing the conditions used to select the records
that you want to report. You must have already created this alert definition in the currently active
repository. To select from a list of alert definitions in the repository, press Prompt (F4).
To create a new alert definition, return to the primary option menu, and then select option 8.5. For
details, see Statistics alert reporting.
To use a different Repository, return to the primary option menu, and then select option 0.3. If you define more than one Statistics Alert report in a Report Set, the reports must all refer to Alert Definitions stored in the same Repository; the JCL for a Report Set can refer to only one Repository.
CICS PA JCL generation translates this option to the STALTDEF operand.
The line actions available on this panel are the same as on similar Reports list panels. See Performance List report.
To display the Statistics Alert Report panel, enter line action S against the Alert Statistics Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.
File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Statistics Alert Report
Command ===> _________________________________________________________________
System Selection: Report Output:
APPLID . . CICSP001 + DDname . . . . . . . . . STAL0001
Image . . MVS1____ + Print Lines per Page . . ___ (1-255)
Group . . ________ +
Alert . . . IDDS____ +
Report Sorted By: Report Type (APPLID and Alert only):
1 1. APPLID / List _ Summary
2. Alert
3. Collection Time
4. Statistics Interval
5. Resource
Report Format:
Title . . ________________________________________________________________
________________________________________________________________
Filter Criteria:
Type . . . . . / EOD / INT / USS / REQ / RRT
Repository . . : CICSPA.XYX.REPOSTRY
Use this panel to specify report options for the Statistics Alert report. The report format is fixed. The only mandatory options are the DDname for the report output and the Alert. You can let the other options default.
The options are:
- Report Output DDname
- The DDname for the report output which CICS PA uses
when generating the JCL to run the Report Set. The DDname is mandatory
and should be unique to separate the output of multiple reports.
CICS PA assigns a default DDname STALnnnn where nnnn is a sequential number 0001-9999 to ensure each report has a unique DDname.
This option generates the OUTPUT(ddname) operand.
- Print Lines per Page
- The maximum number of lines, including headings, to print on each
page of the report. Valid values are from 1 to 255. The default is 60.
The global value applies to all reports. If a value is specified on this report panel, the report value takes precedence over the global for this report only.
CICS PA JCL generation translates this field to the LINECount(nnn) operand.
- Report Sorted By and Report Type
- The sort order of the report. For reports sorted by APPLID or
Alert, you can specify a report type: List (the default), Summary,
or both. Other sorting options are available only as List reports.
List reports show each instance of an Alert on a separate row, with
details such as the threshold value and the Formula value that triggered
the Alert. Summary reports show the number of Alerts for the report
period, rather than the details of each instance.
This option generates the BY operand.
- Filter Criteria
- 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
- REQ
- Requested
- USS
- Unsolicited
- INT
- Interval
- RRT
- Requested reset
Selecting none of the types is the same as selecting all types.
This option generates the TYPE operand.
- Title
- Title of the report. Specify up to 128 characters of text to describe
the report. CICS PA concatenates
the two lines of 64 exactly as entered to make one line which prints
at the top of each page of the report below the heading. The default
is blank (no title).
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.