Start of change

Combining summary data from multiple STIDs

You can use the COPY command to create a report form that combines statistics summary data from more than one statistics type (STID). This procedure is also known as cross-domain reporting.

About this task

After you select an existing report form, you will use the Copy Statistics Reports Form panel to select the STIDs that contain the additional statistics fields you want to add. The Copy Statistics Reports Form panel lists the STIDs that are eligible to include in the form because they share a common key field with an STID that is already in the report form. The key fields APPLID, IMAGE, and COLLECTION TIME are common to all STIDs. Therefore if these are the only key fields that are active in a report form, all STIDs are eligible to include in the form.

The copied STID fields are placed below EOR. You must move the fields you want above EOR to include them in the report. CICS PA validates the report form when you move a field above EOR, and when you press F3. If the report does not produce the results you expect, check which key fields are active, and deactivate any that are not common to all the included STIDs.

Procedure

  1. Select option 3 Report Forms from the CICS PA Primary Option Menu.
  2. Enter line action S against an existing Statistics Summary report form.
  3. Enter the COPY primary command on the command line. The Copy Statistics Reports Form panel is displayed.
  4. Enter line action S against the STID whose statistics you want to add to the report form. The Statistics Summary Report Form panel displays the definition of the report form including the eligible statistics from the STID you selected. These new statistics fields are listed below EOR.
  5. Enter line action M or MM to move the new statistics you want above EOR.
  6. Press Exit (F3) to save the report form.

Example

The following example shows how to create a cross-domain report form based on the Dispatcher TCB Modes STID, but adding a statistics field from the Dispatcher TCB Pools STID.

Figure 1. Cross-domain reporting - Edit Statistics Report Form
   
 EDIT                     EDIT Statistics Reports Form - CD2      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. Cross-domain reporting - Copy Statistics Reports Form
  
                    EDIT Dispatcher TCB Modes - CD2               
 Command ===> COPY                                              Scroll ===> PAGE

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

                                                         Page width . : 315    


     Field                                            Sort
 /   Heading +                                        K  O Fn
     TCB POOL                                         K  A     
     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 STEALS                                            TOT 
     TCB MISMATCHES                                        TOT 
     MVS WAITS                                             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 
     TCB CPU / DISPATCH RATIO                              TOT 
     EOR -------------- END OF REPORT --------------           
 ******************************* Bottom of data ********************************
 
Figure 3. Cross-domain reporting - selecting STID that contains additional statistics fields
  
 EDIT                     EDIT Statistics Reports Form - CD2      Line 1 of 113 
 Command ===>                                                  Scroll ===> PAGE

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

              ** Report **                                                      
           -       CICS Dispatcher
                   S    Dispatcher TCB Pools
              ** End of Reports **
Figure 4. Cross-domain reporting - moving statistics field into form
                    EDIT Dispatcher TCB Modes - CD2         Row 1 of 33 More: > 
 Command ===>                                                  Scroll ===> PAGE

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

                                                         Page width . : 250    


     Field                                            Sort
 /   Heading +                                        K  O Fn
     TCB POOL                                         K  A     
     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 STEALS                                            TOT 
     TCB MISMATCHES                                        TOT 
     MVS WAITS                                             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 
 A   TCB CPU / DISPATCH RATIO                              TOT 
     EOR -------------- END OF REPORT --------------           
     MAX TCB POOL LIMIT                                    FIN 
 M   PEAK TCBS ATTACHED                                    MAX 
     PEAK TCBS IN USE                                      MAX 
     MAX TCB COUNT                                         MAX 
     TOTAL MAX TCB WAIT TIME                               TOT 
     TOTAL MVS STORAGE WAIT TIME                           TOT 
     TOTAL MAX TCB WAITS                                   TOT 
     TOTAL MVS STORAGE WAITS                               TOT 
     PEAK MAX TCB WAITS                                    MAX 
 
End of change