MONGROUP (Monitor groups)

A monitor group is used to associate one or more related monitor definitions. An example of how to use this view can be found in Monitoring programs in multiple CICS systems.

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

   MONGROUP [mongroup]

where mongroup is a specific or generic name of a monitor group. If you omit this parameter, the view, illustrated in Figure 63, includes information about all monitor groups within the current context.

Figure 63. The MONGROUP view
 27FEB2005  19:33:31 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MONGROUP==========EYUPLX01=EYUPLX01=27FEB2005==19:33:31=CPSM==========6===
 CMD Monitor  Monitor Group
 --- Group--- Description-------------------
     EYUMOG01 SSet - All Connections
     EYUMOG02 SSet - CO* , TDQs, CSD, JRNLs
     EYUMOG03 SSet - All SP* term, CEMT tran
     EYUMOG04 SSet - EYUF* files
     EYUMOG05 SSet - ET* transactions
     EYUMOG06 SSet - EYU* programs
 

Action commands and overtype fields

Table 40 summarizes the action commands you can use with the MONGROUP view. Table 41 identifies the overtype field you can modify when you use the SET action command.

Table 40. MONGROUP view action commands
Primary command Line command Description
n/a ADD Add an association between a monitor group and a monitor specification, as described in topic Adding an association to a monitor specification.
n/a ASC Add an association between a monitor definition and a monitor group, as described in topic Associating a monitor definition with a monitor group.
n/a BRO Browse a monitor group in the data repository.

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

CREate CRE Create a monitor group and add it to the data repository, as described in topic Creating a monitor group.
n/a INS Install the monitor definitions associated with a monitor group into a CICS® system or CICS system group, as described in topic Installing a monitor group.
n/a MAP Display a visual map of resource monitoring definitions using the specified group as a starting point.
n/a REM Remove a monitor group from the data repository. (Any associations that exist between monitor definitions and that monitor group are also removed.)
n/a REP Replace all installed monitor definitions with those associated with a monitor group.

The format of the resulting panel is similar to the one produced by the INS action command, as illustrated in Figure 67.

REP causes a two-step operation to be performed. First, all installed monitor definitions are discarded and all accumulated monitoring data relating to those monitor definitions is deleted. Then, CICSPlex® SM attempts to install the monitor definitions associated with the designated monitor group.

n/a SET Change a monitor group description using an overtype field (see Table 41).
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 a monitor group in the data repository.

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

Table 41. MONGROUP view overtype field
Field name Value
Monitor Group Description One- to 30-character description of the monitor group.

Hyperlink fields

Table 42 shows the hyperlink field on the MONGROUP view.

Table 42. MONGROUP view hyperlink field
Hyperlink field View displayed Description
Monitor Group MONINGRP Detailed information about the associations that exist between the designated monitor group and monitor definitions.

Creating a monitor group

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

Figure 64. Creating a monitor group
 ----------------------- Create Monitor Group for EYUPLX01 ---------------------
 COMMAND  ===>
 
 Group Name    ===>
 Description   ===> Test monitor group
 
 
Press Enter to create Monitor Group.
Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate:

Group Name
Specify a 1- to 8-character name for the monitor 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 monitor group.

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

Adding an association to a monitor specification

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

Figure 65. Associating a monitor group with a monitor specification
 ----------------------- Add Group to Specification for EYUPLX01 ---------------
 COMMAND  ===>
 
 Monitor Group Name      EYUMOG01
 Description             Sample monitor group
 
 Specification name ===> EYUMOS01      Specification Name or Generic
 
 
 Press Enter to add Monitor Group to Specification.
 Type END or CANCEL to cancel without adding.

Provide the following information:

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

Press Enter to associate a monitor group with the designated monitor specification in the data repository.

If a monitor specification appropriate for this monitor group does not currently exist, you must first create one, as described in topic Creating a monitor specification. You can then use the ADD action command described in topic Adding a monitor group to a monitor specification to associate the monitor group with that specification.

Associating a monitor definition with a monitor group

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

Figure 66. Associating a monitor definition with a monitor group
 ---------------- Add Monitor Definition to Group for EYUPLX01 -----------------
 COMMAND  ===>
 
 Monitor Group Name           EYUMOG01
 Description                  Sample monitor group
 
 Monitor Definition Name ===> EYUMOD01    Monitor Definition or Generic
 Active Period           ===> EYUMOD01    Period Definition or Generic
 
 
 Press Enter to add Monitor Definition to Group.
 Type END or CANCEL to cancel without adding.

Provide the following information, as appropriate:

Monitor Definition Name
Enter the specific or generic name of an existing monitor definition that is to be associated with the monitor group. If you specify a generic value, a list of valid monitor 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 monitor 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 monitor definition remains active for as long as the CICS system is running, or until you discard it.

Press Enter to associate the monitor definition with the monitor group in the data repository.

Installing a monitor group

When you install a monitor group, all of the monitor definitions associated with that group are installed in the CICS systems that are using the monitor specification to which the monitor group is associated. Before attempting to install a monitor group, you should review the requirements described in Activating resource monitoring.

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

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

Figure 67. Installing a monitor group
 --------------------- Install Monitor Group for EYUPLX01 ----------------------
 COMMAND  ===>
 
 Name                     EYUMOG01
 Description              Sample monitor group
 
 Scope               ===>              CICS 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 monitor definitions associated with this monitor 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 monitor definitions associated with the monitor group into the designated CICS system or into all of the CICS systems associated with the designated CICS system group.

When one or more monitor definitions associated with the monitor group you install:

Finally, you can use the MONACTV view, as indicated in Table 3, to deactivate an installed monitor definition.

[[ Contents Previous Page | Next Page Index ]]