Start of change

STATISTICS SUMMARY Report Form

The Statistics Summary Report Form panel defines the format and content of the Statistics Summary report.

When you create a new statistics summary form, a statistics report tree is displayed, in which the reports are grouped by category.

When you enter line action S against a report in the tree, the Statistics Summary Reports Form is displayed so you can select the fields you want to include in the form. Scroll Right (F11) to see the second view, in which Field Name is displayed instead of Field Heading.

Figure 1. Statistics Summary Report Form tree
   File  Edit  Options  Help 
 ───────────────────────────────────────────────────────────────────────────────
 EDIT                     EDIT Statistics Reports Form - STSUM    Line 1 of 113 
 Command ===>                                                  Scroll ===> PAGE

 Description    Statistics Summary Report Form           VRM TS: 700 TG: 910

              ** Report **                                                      
      -       Regions
                   Transaction Manager
                   Monitoring
           -       CICS Dispatcher
                        Dispatcher Overview
                   S    Dispatcher TCB Modes
                        Dispatcher TCB Pools
                        MVS TCB Overview
                        MVS TCBs
           -       CICS Storage
                        Storage Overview
                        DSAs
                        Domain Subpools
                        Task Subpools
           -       CICS Dumps
                        Transaction Dump Overview
                        Transaction Dumps
                        System Dump Overview
                        System Dumps
                   Enqueue Pools
                   BUNDLE Resources
      -       Connectivity
                   VTAM
                   Terminal Autoinstall
                   Terminals
                   ISC/MRO Connections
                   LU62 Mode Names
                   ISC Security
                   TCP/IP Overview
                   TCPIPSERVICE Resources
                   IPCONN Resources
                   FEPI Connections
                   FEPI Pools
                   FEPI Targets
   -DSLIST  *CMD                                                                
Figure 2. Statistics Summary Report Form
   File  Edit  Confirm  Upgrade  Options  Help 
  ------------------------------------------------------------------------------
                EDIT Dispatcher TCB Modes - STSUM           Row 1 of 24 More: > 
 Command ===>                                                  Scroll ===> PAGE

 Description  . . . Statistics Summary Report Form       VRM TS: 700 TG: 910

                                                         Page width . : 130  

     Field                                            Sort
 /   Heading +                                        K  O Fn
     APPLID                                           K  A     
     IMAGE                                            K  *     
     COLLECTION TIME                                  K  *     
     TCB MODE NAME                                    K  *     
     TCB POOL                                         K  *     
     TCB ATTACHES                                          TOT 
     TCB ATTACH FAILURES                                   TOT 
     PEAK TCBS ATTACHED                                    MAX 
     PEAK MODE TCBS                                        MAX 
     TCB ALLOCATES                                         TOT 
     TCB DETACHES UNCLEAN                                  TOT 
     TCB DETACHES STOLEN                                   TOT 
     TCB DETACHES EXCESS                                   TOT 
     TCB DETACHES OTHER                                    TOT 
     TCB MISMATCHES                                        TOT 
     PEAK DISPATCHABLE QUEUE TASKS                         MAX 
     AVE DISPATCHABLE QUEUE TASKS                          MAX 
     TOTAL MVS WAIT TIME                                   TOT 
     TOTAL TCB DISPATCH TIME                               TOT 
     TOTAL TCB DS CPU TIME                                 TOT 
     TOTAL TCB CPU TIME                                    TOT 
     EOR -------------- END OF REPORT --------------           
 ******************************* Bottom of data ********************************
 
   File  Edit  Confirm  Upgrade  Options  Help 
  ------------------------------------------------------------------------------
                EDIT Dispatcher TCB Modes - STSUM           Row 1 of 24 More: > 
 Command ===>                                                  Scroll ===> PAGE

 Description  . . . Statistics Summary Report Form       VRM TS: 700 TG: 910

 Title  . .                                                                  
                                                                             

     Field                                                           Sort
 /   Name +                                                          K  O Fn
     APPLID                                                          K  A     
     IMAGE                                                           K  *     
     COLLECTTIME                                                     K  *     
     DSGTCBNM                                                        K  *     
     DSGTCBMP                                                        K  *     
     DSGNTCBA                                                             TOT 
     DSGTCBAF                                                             TOT 
     DSGTCBPA                                                             MAX 
     DSGTCBPU                                                             MAX 
     DSGTCBAL                                                             TOT 
     DSGTCBDU                                                             TOT 
     DSGTCBDS                                                             TOT 
     DSGTCBDX                                                             TOT 
     DSGTCBDO                                                             TOT 
     DSGTCBMM                                                             TOT 
     DSGTMPDQ                                                             MAX 
     DSGTMADQ                                                             MAX 
     DSGTWT                                                               TOT 
     DSGTDT                                                               TOT 
     DSGTCT                                                               TOT 
     DSGACT                                                               TOT 
     EOR -------------- End of Report --------------                          
 ******************************* Bottom of data ********************************

The Statistics Summary form consists of the following fields:

Description
Up to 32 characters of text to describe the purpose of the report form. This description is shown to help you identify the forms in the list. It is initially set to Statistics Summary Report Form.
TS
This identifies the CICS® Transaction Server release that this report form is created for. There are differences in the reports and fields that are available in each CICS Transaction Server release.
TG
This identifies the CICS Transaction Gateway release that this report form is created for. There are differences in the reports and fields that are available in each CICS Transaction Gateway release.
Page Width
Page Width is the width of the report page for all form fields above the EOR marker. Page Width changes when you move fields above EOR or below EOR.
Field Heading
One of the following values:
  • The CICS Transaction Server or CICS Transaction Gateway statistics field heading. Use line action S or prompt (F4) to select from a list of fields applicable to this form type and CICS version. You can manually enter the field heading of any valid statistics field.
  • The special entry EOR.

    EOR is managed by CICS PA. It signals the end of the report line. The fields listed above EOR are included in the report in the same order as they appear in the list. Those below EOR will not be reported and are ignored.

    CICS PA automatically sets EOR when the report form is created and resets it if necessary when you move fields above or below EOR. In positioning EOR, CICS PA allows for one blank separator between each field.

Field Name
One of the following values:
  • The CICS Transaction Server or CICS Transaction Gateway statistics field. Use line action S or prompt (F4) to select from a list of fields applicable to this form type and CICS version.
  • The special entry EOR.

    EOR signals the end of the report line.

Sort K
A K in the Sort K column identifies a key field. The data in the report is summarized by the value of each key field.
Sort O
If A (ascending) or D (descending) appears in the Sort O column, the report is summarized and ordered by that field. A sort order of * (asterisk) identifies a candidate sort field. Sort fields marked with *, and those that are blank, are ignored for reporting purposes.

To activate a candidate sort field, move it to the top of the form and set the Sort O column to A or D. Key fields above EOR must appear first in the list of fields. Key fields below EOR are ignored. The combined total length of all key fields cannot exceed 255 bytes. The order of the key fields in the list defines the sort and summarization precedence, so that the first key field is the major sort field.

For a report to run successfully, each activated sort field must be a common key field for all the STIDs that have provided data for the report. The fields APPLID, IMAGE, and COLLECTTIME are common to all STIDs, and therefore they are available for any Statistics Summary report form. They are called global keys.

APPLID
The CICS Transaction Server generic APPLID or CICS Transaction Gateway APPLID. Some statistics data fields require APPLID for a report to run successfully. CICS PA prevents you from creating a report form that is missing APPLID if it is mandatory, and a report that is missing a mandatory APPLID field fails to run.
IMAGE
The SMF identifier of the MVS system where the CICS system runs.
COLLECTTIME
The collection time of the statistics interval.
Tip: You can create a report that combines TS and TG statistics if the fields in the report share a common key value such as IMAGE or COLLECTTIME.
Fn (Function)
The summary function applied to each non-key field. You must specify a summary function for each non-key field to run the report successfully. The valid functions are:
MAX
Maximum value.
MIN
Minimum value.
TOT
Total.
Start of changeFINEnd of change
Start of changeLast value stored in the field. This is useful when you want to show a fixed or final value in a report to provide context, for example Current MAXTASK (XMGMXT) or Max TCB Pool Limit (DSGMXTCB).
Note: To provide context, if the form contains a field with a FIN function applied to it, the form must also include APPLID as a key field.
End of change

Line Actions

For the list of valid line actions for the STATISTICS SUMMARY Report Form panel, see Line Actions.

Primary Commands

The following primary command is available only on the STATISTICS SUMMARY Report Form panel:
COPY
This command combines summary fields from multiple STIDs into a single report form. STIDs that share a common key field are eligible for combination. This feature is known as cross-domain reporting.

After you type COPY and press Enter, you can select the STIDs whose fields you want to add into the report form that you are editing.

For a list of other valid primary commands for the STATISTICS SUMMARY Report Form panel, see Primary Commands.

End of change