RTAGROUP (Analysis groups)

An analysis group is used to associate one or more related analysis definitions, status definitions, or both. Examples of how to use this view can be found in:

To display information about existing analysis groups, issue the command:

   RTAGROUP [rtagroup]

where rtagroup is the specific or generic name of an analysis group. If you omit this parameter, the resulting view, illustrated in Figure 25, includes information about all analysis groups for the CICSplex identified as the context.

Figure 25. The RTAGROUP view
 27FEB2005  21:02:56 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =RTAGROUP==========EYUPLX01=EYUPLX01=27FEB2005==21:02:56=CPSM==========4===
 CMD Analysis Description
 --- Group--- ------------------------------
     EYURTGLC SSet - License
     EYURTG01 SSet - FOR related definitions
     EYURTG02 SSet - Plex wide definitions
     EYURTG07 SSet - TOR related definitions
 

Action commands and overtype fields

Table 14 summarizes the action commands you can use with the RTAGROUP view. Table 15 identifies the overtype fields you can modify when you use the SET action command.

Table 14. RTAGROUP view action commands
Primary command Line command Description
n/a AAP Add an association between an analysis group and an analysis point specification, as described in topic Adding an association to an analysis point specification.
n/a ADD Add an association between an analysis group and an analysis specification, as described in topic Adding an association to an analysis specification.
n/a AIN Install an analysis group in an active analysis point specification, as described in topic Installing an analysis group into an analysis point specification.
n/a ASC Add an association between an analysis or status definition and an analysis group, as described in topic Associating a definition with an analysis group.
n/a BRO Browse an analysis group in the data repository.

The format of the resulting panel is similar to that shown in Figure 26. The panel fields are not modifiable.

CREate CRE Create an analysis group and add it to the data repository, as described in Creating an analysis group.
n/a INS Install an analysis group in a CICS® system or CICS system group, as described in topic Installing an analysis group.
n/a MAP Display a visual map of real-time analysis definitions using the specified group as a starting point.
n/a REM Remove an analysis group from the data repository.
n/a SET Change the description of an analysis group using an overtype field (see Table 15).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
TEMPMP cmasid n/a Change the temporary maintenance point CMAS to a specific CMAS or display a selection list based on a generic CMAS ID.
n/a UPD Update an analysis group in the data repository.

The format of the resulting panel is similar to that shown in Figure 26. You can change the Description field.

Table 15. RTAGROUP view overtype fields
Field name Value
Description One- to 30-character description of the analysis group.

Hyperlink fields

Table 16 shows the hyperlink field on the RTAGROUP view.

Table 16. RTAGROUP view hyperlink field
Hyperlink field View displayed Description
Analysis Group RTAINGRP Detailed information about analysis and status definitions associated with the designated analysis group.

Creating an analysis group

Figure 26 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the RTAGROUP view.

Figure 26. Creating an analysis group
 ------------------------- Create Analysis Group for EYUPLX01-----------
 COMMAND  ===>
 
  Group Name          ===>  EYURTG02
  Description         ===>  SSet - Plex wide definitions
 
 
 
 
 
Press Enter to create Analysis Group.
Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

Name
Specify a 1- to 8-character name for the group. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Description
(Optional.) Specify a 1- to 30-character description of the group.

Press Enter to add the analysis group to the data repository.

Adding an association to an analysis point specification

Figure 27 illustrates the panel produced when you use the add (AAP) line action command from the RTAGROUP view.

Figure 27. Adding an analysis group and analysis point specification association
------------------ Add Analysis Group to AP Specification for EYUPLX01 --------
 COMMAND  ===>
 
  Analysis Group                     EYURTG01
  Description
 
  Analysis Specification Name  ===>  EYURTS02  Spec Name or Generic
 
  Scope                        ===>            System, Group, or Generic
 
Press ENTER to add Analysis Group to Specification.
Type END or CANCEL to cancel without adding.
 

Provide the following information:

Analysis Specification Name
Enter the specific or generic name of an existing analysis point specification. If you specify a generic value, a list of valid analysis point specifications is displayed.
Scope
(Optional.) Enter the specific or generic name of a CICS system or CICS system group that is to be evaluated by the analysis point when processing analysis definitions. If you specify a generic value, a list of valid CICS systems and CICS system groups is displayed. If you leave this field blank, all CICS systems in the CICSplex are evaluated.

Adding an association to an analysis specification

Figure 28 illustrates the panel produced when you use the add (ADD) line action command from the RTAGROUP view.

Figure 28. Adding an association between an analysis group and specification
-------------Add Analysis Group to Analysis Specification for EYUPLX01 ---------
 COMMAND  ===>
 
  Analysis Group            EYURTG01
  Description               SSet - FOR related definitions
 
  Specification Name  ===>  EYURTS01   Specification Name or Generic
 
 
Press Enter to add RTA Group to RTA Specification.
Type END or CANCEL to cancel without adding.

Provide the following information:

Specification Name
Enter the specific or generic name of an existing analysis specification. If you specify a generic value, a list of valid analysis specifications is displayed.

Press Enter to add the name of the analysis specification to the designated analysis group.

If the appropriate analysis specification does not currently exist, you must first create it, as described in topic Creating an analysis specification. Then you can add the group to that specification, using either this action command or the action command described in topic Adding an analysis group to an analysis specification.

To remove a group from an analysis specification, see topic Action commands.

Associating a definition with an analysis group

Figure 29 illustrates the panel produced when you use the associate (ASC) line action command from the RTAGROUP view.

Figure 29. Associating a definition with an analysis group
 --------------- Add Analysis Definition to Group for EYUPLX01 -----------------
 COMMAND  ===>
 
 Analysis Group Name           EYUROG01
 Description                   Sample analysis group
 
 Analysis Definition Name ===> EYUMOD01    Analysis Definition or Generic
 Active Period            ===> EYUMOD01    Period Definition or Generic
 
 
 Press Enter to add Analysis Definition to Group.
 Type END or CANCEL to cancel without adding.

Provide the following information, as appropriate:

Definition Name
Enter the specific or generic name of an existing analysis or status definition that is to be associated with the analysis group. If you specify a generic value, a list of valid definitions is displayed.
Active Period
(Optional) Enter the specific or generic name of a period definition that identifies the range of hours during which the analysis or status definition is to be active. If you specify a generic value, a list of valid period definitions is displayed.

If the name you specify does not belong to an existing period definition you can create that period definition later. If you leave this field blank, the analysis or status definition remains active for as long as the CICS system is running, or until you discard it.

Press Enter to associate the analysis or status definition with the analysis group in the data repository.

Installing an analysis group

When you install an analysis group, all of the analysis definitions associated with that group are installed in the CICS systems that are using the analysis specification to which the analysis group is associated.

Note:
The analysis definitions associated with an analysis group can be automatically installed in a CICS system when that system starts. For this to occur, the analysis group must be associated with an analysis specification that is defined to the CICS system.

Figure 23 illustrates the panel produced when you use the install (INS) line action command from the RTAGROUP view.

Figure 30. Installing an analysis group
 ----------------------- Install RTAGROUP for EYUPLX01 -------------------------
 COMMAND  ===>
 
 Name                     EYURTG02
 Description              SSet - Plex wide definitions
 
 Type                     RTAGROUP
 
 Scope               ===>              CICS System, System Group, or Generic
 
 Press Enter to install definitions.
 Type END or CANCEL to cancel without installing.

Provide the following information:

Scope
Enter the specific or generic name of an active CICS system or CICS system group into which the analysis definitions associated with this analysis group are to be installed. The CICS system or CICS system group must be within the CICSplex identified as the current context. If you specify a generic value, a list of valid CICS systems and CICS system groups is displayed.

Press Enter to install the analysis definitions associated with the analysis group into the designated CICS system or into all of the CICS systems comprising the designated CICS system group.

For an installation to succeed, the CICS system must be running and real-time analysis must be active. The analysis definition becomes active either:

The analysis definition remains active as long as the CICS system is running, until you discard it, or until the time designated by an associated period definition is reached.

To discard an analysis definition installed in a CICS system, use the RTAACTV view as described in Table 3.

Installing an analysis group into an analysis point specification

Figure 31 illustrates the panel produced when you use the install (AIN) line action command from the RTAGROUP view.

Figure 31. Installing an analysis group into an analysis point specification
 ----------------------- Install RTAGROUP for EYUPLX01 -------------------------
 COMMAND  ===>
 
 Name                     EYURTG01
 Description              SSet - FOR related definitions
 
 Type                     RTAGROUP
 
 AP Spec Name        ===>              Active Analysis Point Spec or Generic
 Scope               ===>              CICS System, Group, or Generic
 
 Press Enter to install definitions.
 Type END or CANCEL to cancel without installing.

Provide the following information:

AP Spec Name
Enter the specific or generic name of the analysis point specification to which the analysis definitions in this group are to be added. If you specify a generic value, a list of valid analysis point specifications is displayed.
Scope
(Optional.) Enter the specific or generic name of a CICS system or CICS system group that is to be evaluated by the analysis point specification when processing analysis definitions. If you specify a generic value, a list of valid CICS systems and CICS system groups is displayed. If you leave this field blank, all CICS systems in the CICSplex are evaluated.

Press Enter to install the analysis definitions comprising the analysis group into the designated analysis point specification.

[[ Contents Previous Page | Next Page Index ]]