MONSCOPE (Monitor specifications assigned a scope)

To display information about the CICS® systems or CICS system groups that are associated with a monitor specification, issue the command:

   MONSCOPE [monspec]

where monspec is a specific or generic name of a monitor specification. If you omit this parameter, the view, illustrated in Figure 72, includes information about all monitor specifications, and the associated scope information, for the CICSplex identified as the context.

Figure 72. The MONSCOPE view
 27FEB2005  19:34:15 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MONSCOPE==========EYUPLX01=EYUPLX01=27FEB2005==19:34:15=CPSM==========8===
 CMD Monitor  Scope    Scope    Scope    Scope    Update
 --- Spec---- Name---- Type---- Link---- Mode---- Option
     EYUMOS01 EYUMAS1A CICSSYS           EXPLICIT
     EYUMOS02 EYUCSG03 SYSGROUP
     EYUMOS02 EYUCSG04 SYSGROUP
     EYUMOS02 EYUCSG05 SYSGROUP
     EYUMOS02 EYUMAS1B CICSSYS  EYUCSG03 INHERIT
     EYUMOS02 EYUMAS2A CICSSYS  EYUCSG04 INHERIT
     EYUMOS02 EYUMAS3A CICSSYS  EYUCSG05 INHERIT
     EYUMOS03 EYUMAS4A CICSSYS           EXPLICIT
 

Action commands and overtype fields

Table 48 summarizes the action commands you can use with the MONSCOPE view. Table 49 identifies the overtype fields you can modify when you use the SET action command.

Table 48. MONSCOPE view action commands
Primary command Line command Description
n/a BRO Browse the association between a scope and a monitor specification.

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

n/a MAP Display a visual map of resource monitoring definitions using the designated specification as a starting point.
n/a REM Remove the association between a scope and a monitor specification, as described in topic Removing scope-to-monitor specification associations.
n/a SET Change the association between a scope and a monitor specification using overtype fields (see Table 49).
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 the association between a scope and a monitor specification, as described in topic Updating scope-to-monitor specification associations.

When you change or remove the monitor specification associated with a CICS system group, you must indicate how the CICS systems comprising that group are to be affected.

Based on the value you specify, the number of entries shown in the MONSCOPE view may increase or decrease. For example, you might specify a value that causes a CICS system within a CICS system group to be explicitly associated with a specification, rather than inherit it from its CICS system group. When this happens, the resulting MONSCOPE view contains a line identifying the CICS system group and a new line identifying the CICS system that is now explicitly associated with a specification.

Table 49. MONSCOPE view overtype fields
Field name Value
Monitor Spec 1- to 8-character name of an existing monitor specification that is to be associated with the CICS system or CICS system group.
Update Option FORCE | KEEP | NAME | NULL
Notes:
  1. When the scope of the monitor specification is a CICS system group, you must indicate how the CICS systems comprising the CICS system group are to use the specification by overtyping the contents of the Update Option field.

    If the CICS system group includes other CICS system groups, all of the CICS systems, including those in the subordinate CICS system groups, are affected by the value specified in the Update Option field.

  2. If you update the monitor specification for a CICS system that is already active, you must restart resource monitoring, as described in Updating scope-to-monitor specification associations.

Hyperlink fields

Table 50 shows the hyperlink field on the MONSCOPE view.

Table 50. MONSCOPE view hyperlink fields
Hyperlink field View displayed Description
Monitor Spec MONSPEC Detailed information about the designated monitor specification.

Updating scope-to-monitor specification associations

Figure 73 illustrates the panel produced when you use the update (UPD) line action command from the MONSCOPE view.

Figure 73. Updating the association between a scope and a monitor specification
 --------- Update Monitor Specification to Scope for EYUPLX01 -----------------
 COMMAND  ===>
 
   Specification Name   ===> EYUMOS01   Specification Name or Generic
   Scope                     EYUCSG01
   Scope Type                SYSGROUP
 
   Option               ===>            FORCE, KEEP, NAME, or NULL
 
 
 
  Press ENTER to update Specification Link.
  Type END or CANCEL to cancel without updating.

The Option field does not appear on this panel when the scope is a CICS system (CICSSYS).

Change the following information, as appropriate:

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.
Option
When the scope of the monitor specification is a CICS system group, you must indicate how the CICS systems comprising the CICS system group are to use the specification. To do this, specify one of the following:
FORCE
All CICS systems in the CICS system group are to inherit the new specification.
KEEP
Any CICS system that inherited a specification from the CICS system group is to be explicitly assigned the old specification; all other CICS systems in the group are to be unaffected.
NAME
Any CICS system that inherited a specification from the CICS system group is to be explicitly assigned the new specification; all other CICS systems in the group are to be unaffected.
NULL
Any CICS system in the CICS system group that is not explicitly associated with a specification is to inherit the new specification; all other CICS systems in the group are to be unaffected.
If the CICS system group includes other CICS system groups, all of the CICS systems, including those in the subordinate CICS system groups, are affected by the value specified in the Option field.

If you update the monitor specification for a CICS system that is already active, the new specification is not immediately available. To reset resource monitoring, you must display the MAS view and use the UPD action command to do one of the following:

Resource monitoring becomes active using the new monitor specification.

Removing scope-to-monitor specification associations

Figure 74 illustrates the panel produced when you use the remove (REM) line action command from the MONSCOPE view.

Figure 74. Removing the association between a scope and a monitor specification
 -------------- Confirm Removal of Specification Link from EYUPLX01 ------------
 COMMAND  ===>
 
 Specification Name       EYUMOS01
 Scope                    EYUMAS1A
 Scope Type               CICSSYS
 
 Option             ===>            KEEP or blank
                                    Valid only for SYSGROUP
 
 WARNING: For this definition type, removal will cascade through
          related associations.
 
 Press Enter to remove Specification Link.
 Type END or CANCEL to cancel without removing.

The Option field does not appear on this panel when the scope is a CICS system (CICSSYS).

Provide the following information when the scope is a CICS system group:

Option
Indicate how the CICS systems comprising the CICS system group are to use the monitor specification associated with the CICS system group. Specify:
KEEP
Those CICS systems that inherited the specification from the CICS system group are explicitly assigned that specification.
Blank
Those CICS systems that inherited the specification from the CICS system group are not to use that specification.

If the CICS system group identified as the scope includes other CICS system groups, all of the CICS systems, including those in the subordinate system group, are affected by the value specified in the Option field.

Press Enter to remove the scope from the designated monitor specification in the data repository.

[[ Contents Previous Page | Next Page Index ]]