Creating groups

To be monitored, elements must be contained in at least one group.

To create a group, select the Create Group option (B) on the Groups path or enter fast path G.B from any panel. This produces a panel to create a group and specify its attributes as shown in the following figure:

Figure 1. Create Group Panel (G.B)
 ________________ ZGADDG   VTM     CICSMH01 V550./C SYS  03/16/17 23:46:40      
> PF1 Help     PF3 Back     PF4 Main Menu     PF7 Up     PF8 Down               
                                                                                
> A-Group Summary      B-Create Group       C-Add Element      D-Update Group   
> E-Update Element     F-Delete Element     G-Clear Group      H-List Group     
=============================================================================== 
>                               CREATE GROUP                                    
                                                                                
> To create a group, modify the GRPS statement below as follows:                
>   - Remove the > preceding GRPS                                               
>   - group may be 1 - 30                                                       
>   - name may be a 1 - 12 character group name (default is 'GROUP nn')         
>   - type may be TRAN, TERM, or PROG                                           
>   - n.n is the group average response time threshold (default is 2.0 seconds) 
                                                                                
>GRPS ADD,GROUP=group,NAME=name,TYPE=type,AVERAGE=n.n                           
===============================================================================

Remember to stop the response time collector (fast path O.B) prior to using this panel and any other panels that add or change group or element definitions. Reactivate the collector after you are finished (fast path O.A).

Text on this panel explains how to define a new group. Enter the group number, a name for easy identification, the type of resource this group will contain, and the average response time for the elements within the group.

  1. Begin by moving your cursor to the line containing the GRPS statement.
  2. Remove the greater-than symbol (>) preceding the GRPS statement.
  3. Modify the group definition (GRPS) statement.
  4. Follow the syntax shown in the figure and these guidelines:
    • Use group numbers from 1–30.
    • The group name is for informational purposes. It appears on certain displays to facilitate identification of a group’s contents.
    • The group type must be defined as either a transaction, terminal, or program group. All elements in the group must be of the type defined.
    • The average response time threshold is used by the response time collector to activate the interval record collector and highlight elements that exceed the threshold.
      For example, to create group number 30 as a transaction group for the new Payroll application with an average CICS® response time threshold of 1.2 seconds, the GRPS statement looks like the following statement: 
      GRPS ADD,GROUP=30,NAME=’PAYROLL’,TYPE=TRAN,AVERAGE=1.2

      To create group 27 as a terminal group for line 15 with an average response time of 1.8 seconds, the GRPS statement looks like the following statement:

      GRPS ADD,GROUP=27,NAME=’LINE 15’,TYPE=TERM,AVERAGE=1.8

      When transaction, programs, or terminals are monitored, OMEGAMON for CICS (3270) obtains CICS response time.