MONACTV

The MONACTV view shows information about monitor definitions installed in CICS® systems known to the CICSplex identified as the current context. An example of how to use this view can be found in Finding out which resources are being monitored in a CICS system.

Issue command:
MONACTV [mondef [ACTIVE|PENDING]]

mondef
Is the specific or generic name of a monitor definition or * for all monitor definitions.

ACTIVE|PENDING
Limits the view to either active or pending definitions. If you omit this parameter, monitor definitions are included in the view regardless of their status.

If you do not specify parameters, the view includes information about all monitor definitions within the current context and scope.

Select:
MONACTV from a menu of MONITOR views.

Figure 78 is an example of the MONACTV view.

Figure 78. The MONACTV view
 27FEB2005  19:33:12 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MONACTV===========EYUPLX01=EYUPLX01=27FEB2005==19:33:12=CPSM=========42===
 CMD Def      CICS     Status     Active   Resource Resource Include Res
 --- Name---- System-- ---------- Period-- Name---- Type---  ------- Stat
     *0000000 EYUMAS4A ACTIVE              *        MCICS    YES     YES
     *0000001 EYUMAS4A ACTIVE              *        MGLBL    YES     YES
     *0000002 EYUMAS4A ACTIVE              *        MDBX     YES     NO
     *0000003 EYUMAS1A ACTIVE              *        MCICS    YES     YES
     *0000004 EYUMAS1A ACTIVE              *        MGLBL    YES     YES
     *0000005 EYUMAS2A ACTIVE              *        MCICS    YES     YES
     *0000006 EYUMAS2A ACTIVE              *        MGLBL    YES     YES
     *0000007 EYUMAS3A ACTIVE              *        MCICS    YES     YES
     *0000008 EYUMAS3A ACTIVE              *        MGLBL    YES     YES
     EYUMOD01 EYUMAS1A ACTIVE     EYUPDF01 *        MCONN    YES     NO
     EYUMOD01 EYUMAS2A ACTIVE     EYUPDF01 *        MCONN    YES     NO
     EYUMOD01 EYUMAS3A ACTIVE     EYUPDF01 *        MCONN    YES     NO
     EYUMOD02 EYUMAS1A ACTIVE     EYUPDF01 CO*      MTRAN    YES     YES
     EYUMOD02 EYUMAS2A ACTIVE     EYUPDF01 CO*      MTRAN    YES     YES
     EYUMOD02 EYUMAS3A ACTIVE     EYUPDF01 CO*      MTRAN    YES     YES
     EYUMOD02 EYUMAS4A ACTIVE     EYUPDF01 CO*      MTRAN    YES     YES
 
Default monitor definitions

When you specify a sample rate for the Region, Global, or DB2/DBCTL resource type in a monitor specification, CICSPlex® SM automatically creates a corresponding monitor definition. The first few monitor definitions shown in Figure 78 are examples of these monitor definitions. Notice that:

Monitor definitions created by CICSPlex SM are automatically installed when a CICS system using the associated specification is started. You cannot update or remove these monitor definitions.

Action commands

Table 53 shows the action commands you can issue from the MONACTV view.

Table 53. MONACTV view action commands
Primary command Line command Description
DEActivate
mondef sysname
DEA Deactivates an ACTIVE monitor definition for which a time period is defined; the status of the definition changes to PENDING.
DiSCard
mondef sysname
DSC Discards an ACTIVE or PENDING monitor definition from the CICS system in which it is installed.
Where:
mondef
Is the specific or generic name of a monitor definition.
sysname
Is the specific or generic name of a CICS system.

Hyperlinks

Table 54 shows the hyperlink field on the MONACTV view.

Table 54. MONACTV view hyperlink field
Hyperlink field View displayed Description
Def Name MONDEF Detailed description of the specified monitor definition.
Note:
This hyperlink field is not valid for monitor definitions created by CICSPlex SM, which have names beginning with an asterisk (*); there is no entry for them in the MONDEF view.

Usage

Deactivating or discarding a monitor definition

When a monitor definition is installed, its status (as illustrated by the Status field in Figure 78) is either:

ACTIVE
The definition is installed and active.
PENDING
The definition is installed and ready to become active.

The definition is active during the time period identified in the Period field. (When this field is blank, the monitor definition is to be active as long as the CICS system in which it is installed is running.)

To change the status of an installed monitor definition, type either the DEA or DSC action command in the line command field next to the name of the definition.

Press Enter. A confirmation panel is displayed. Press Enter again to deactivate or discard the monitor definition.

Notes:
  1. You cannot deactivate or discard a monitor definition created by CICSPlex SM. These definitions have names that consist of an asterisk (*) followed by seven digits.
  2. Changes that you make to monitor definitions may be overridden by RTA. If RTA needs a definition that you are attempting to deactivate or had previously deactivated, an error message to that effect is issued and your deactivation is overridden.
  3. Deactivating a monitor definition does not remove the data that has been collected and accumulated up to this point in the current monitor interval. The data continues to be displayed in the appropriate monitor views, whether or not the data is being updated. If you know that the data will not be updated by any other active monitor definitions, you can remove it from the view by using the remove (REM) action command, as described in CICSPlex SM Administration.
  4. If there are multiple monitor definitions, the data for discarded definitions continues to be displayed unless and until all of the definitions are discarded.
  5. While DEA and DSC prevent monitoring of the specific resource occurrence identified in the monitor definition, other active monitor definitions may continue to cause information about that resource occurrence to be gathered. To illustrate, suppose the following monitor definitions are active:
    • EYUMOD01, which identifies all file names beginning with PAY
    • EYUMOD02, which identifies all file names beginning with P
    Discarding EYUMOD01 has no affect on monitoring since EYUMOD02 includes all file names beginning with P. However, discarding EYUMOD02 means that file names beginning with PAY continue to be monitored.
  6. Start of changeIssuing a DSC or DEA command for a MONDEF for the MTRAN class will result in no more history collection for those transactions.End of change
[[ Contents Previous Page | Next Page Index ]]