MONSPEC (Monitor specifications)

A monitor specification identifies one or more CICS® resource types that are to be monitored by CICSPlex® SM. Examples of how to use this view can be found in:

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

   MONSPEC [monspec]

where monspec is a specific or generic monitor specification name. If you omit this parameter, the view, illustrated in Figure 75, includes information about all existing monitor specifications within the current context.

Figure 75. The MONSPEC view
 27FEB2005  19:33:51 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MONSPEC===========EYUPLX01=EYUPLX01=27FEB2005==19:33:51=CPSM==========3===
 CMD Monitor  Monitor Specification         Res Stat
 --- Spec---  Description------------------ CMAS----
     EYUMOS01 SSet - For EYUMAS1A           EYUCMS01
     EYUMOS02 SSet - For EYUMAS2A/3A/1B
     EYUMOS03 SSet - For EYUMAS4A
 

Action commands

Table 51 summarizes the action commands you can use with the MONSPEC view.

Table 51. MONSPEC view action commands
Primary command Line command Description
n/a ADD Add an association between a monitor specification and a scope (CICS system or CICS system group) as described in topic Adding a scope to a monitor specification.
n/a BRO Browse a monitor specification in the data repository.

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

CREate CRE Create a monitor specification and add it to the data repository, as described in topic Creating a monitor specification.
n/a MAP Display a visual map of resource monitoring definitions using the designated specification as a starting point.
n/a REM Remove a monitor specification from the data repository. (When a monitor specification is removed, associations with monitor groups and the CICS system or CICS system group identified as the scope are lost.)
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 specification in the data repository.

The format of the resulting panel is similar to that shown in Figure 76. You may overtype the contents of any field in the panel except Monitor Spec Name.

Changes to a monitor specification that is currently installed in a CICS system take effect the next time you start the CICS system.

Hyperlink fields

Table 52 shows the hyperlink field on the MONSPEC view.

Table 52. MONSPEC view hyperlink field
Hyperlink field View displayed Description
Monitor Spec MONINSPC Detailed information about the associations that exist between the designated monitor specification and its monitor groups.

Creating a monitor specification

Figure 76 shows the format of the panel displayed when you use the create primary (CREate) or line (CRE) action command from the MONSPEC view.

Figure 76. Creating a monitor specification
 ------------------ Create Monitor Specification for EYUPLX01 ------------------
 COMMAND ===>
 
  Monitor Spec Name   ===> EYUMOS03
  Description         ===> SSet - For EYUMAS4A
  Monitor Status      ===> ACTIVE     Monitor Status (Active/Inactive)
  Retention Period    ===> 5          Minutes to retain data after termination
  Res Stat CMAS       ===>            Resource status facility name
 
  Sample Intervals                    Seconds between samples (0 for none)
    Resource Name   Interval      Resource Name   Interval   Class Name
    -------------  ----------     -------------   ---------- ----------
    Region        ==> 300           Transaction    ==> 300       MTRAN
    Global        ==> 300           Terminal       ==> 0         MTERM
    DB2           ==> 300           File           ==> 300       MFILE
                                    Transient Data ==> 300       MTDQS
                                    Journal        ==> 500       MJRNL
                                    Connection     ==> 300       MCONN
                                    Program        ==> 0         MPROG
 
 Press ENTER to create Monitor Specification.
 Type END or CANCEL to cancel without creating.

Provide the following information, as appropriate.

Monitor Spec Name
Specify a 1- to 8-character name for the monitor specification. 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 specification.
Monitor Status
Specify ACTIVE or INACTIVE to indicate whether resource monitoring is to be in effect when a CICS system associated with this monitor specification is started.

If the comparable field in the definition of the CICS system that will be using this specification contains YES or NO (indicating whether resource monitoring is on or off), the value you specify here will be overridden by that value. If the comparable field contains * (asterisk), the value specified in this field is used.

Retention Period
Specify the number of minutes collected data is to be kept after resource monitoring stops. (Resource monitoring stops when the CICS system stops or when the MAS view command is used to stop resource monitoring for the CICS system.) The value must be:
Res Stat CMAS
(Optional) Specify the CMAS that is to convey resource information to the resource status facility. The specified CMAS must be on the MVS™ image where NetView® is running. If you specify a CMAS name, all of the CICS systems associated with this monitor specification are identified to the resource status facility.

If you plan to use the CICSPlex SM API or an automation product to access information provided by the resource status facility, you must specify a CMAS in this field.

Sample Intervals
For each type of resource you want to monitor, specify how long, in seconds, CICSPlex SM is to wait between the collection of sample data. You can specify a sample interval for: The sample interval must be:

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

Adding a scope to a monitor specification

Associating a monitor specification with a scope causes the specification to be automatically installed when a CICS system associated with the scope is started. Any monitor definitions associated with the specification through monitor groups are also automatically installed.

However, if you associate the monitor specification with a CICS system that is already active, the new specification is not immediately available. To turn resource monitoring on, you must display the MAS view and use the UPD action command. Specify YES in the MON Active field and press Enter; resource monitoring becomes active using the new monitor specification.

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

Figure 77. Adding a scope to a monitor specification
 ------------------ Add Scope for Specification for EYUPLX01 -------------------
 COMMAND  ===>
 
 Monitor Spec Name        EYUMOS01
 Description              Test specification 1
 
 Scope               ===>              CICS System, Group, or Generic
 Option              ===>              FORCE, NULL, or NONE for System Group
 
 Press Enter to add Monitor Specification to Scope.
 Type END or CANCEL to cancel without adding.

Provide the following information, as appropriate.

Scope
Enter the specific or generic name of an existing CICS system or CICS system group that is not associated with any other monitor specification. If you specify a generic value, a list of valid CICS systems and CICS system groups is displayed.

A CICS system or CICS system group can be associated with only one monitor specification at a time. A specification, however, can be associated with any number of CICS systems and CICS system groups.

Option
(Required when the scope is a CICS system group.) Indicate how the CICS systems comprising the CICS system group are to handle monitor specifications. Specify:
FORCE
All CICS systems in the CICS system group are to use the monitor specification. (The monitor specification attribute for each CICS system changes to INHERIT, indicating that the CICS system acquired the specification from a CICS system group.)
NULL
Those CICS systems within the CICS system group that are not associated with a monitor specification are to use this specification. (The monitor specification attribute for those CICS systems changes to INHERIT.)
NONE
Only the CICS system group is to be associated with the monitor specification. The CICS systems in the CICS system group are not affected. That is, if there is no association between a CICS system and monitor specification, none is established; if there is an association, either explicitly established or inherited from another CICS system group, it is unchanged.

When 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 this field.

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

[[ Contents Previous Page | Next Page Index ]]