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.

Figure 1. Statistics Alert Reports
   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 APPLID(s) 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, then 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 is 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 that you want to report. You must have already created this Alert Definition in the currently active HDB Register. To select from a list of Alert Definitions in the HDB Register, press Prompt (F4). To create a new Alert Definition, return to the primary option menu, and then select option 7.5. For details, see Statistics alert reporting.

To use a different HDB Register, 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 HDB Register; the JCL for a Report Set can refer to only one HDB Register.

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.

Figure 2. Statistics Alert Report
   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
                                                       
 HDB Register  . : CICSPA.HDB.REGISTER

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.