Starting a monitor

To start a monitor

1. Type SM or MONSERV on the COMMAND line of any view and press Enter.

   The Start Monitors (SM or MONSERV) view is displayed and it lists all available monitors.

   Tip

   To learn about a monitor service, type H in the CMD field next to the service and press Enter. A description of the service, its parameters, and the syntax of its warning message are displayed.

   To learn about a field on the Start Monitors view, position the cursor on the field and press F1 for online Help.

   Start Monitors (SM or MONSERV) view

   ddmmmyyyy  hh:mm:ss ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
   COMMAND  ===>                                                 SCROLL ===> PAGE
   CURR WIN ===> 1        ALT WIN ===>                                            
    W1 =SM===============(BCVDVPC==*=======)ddmmmyyyy==hh:mm:ss====MVCICS===D====1
    -                                 Monitor Services                      
       Commands:   BLK  (Requests)   JOURNAL  (Log Display)                 
       Line CMDs:  S (Select),   L (Lock),   U (unlock),   H(Help)          
                                                                            
    CMD Service  Num    Title                        Parm Type       Area   
    --- -------  Actv   --------------------------   --------------  -----  
        #DSAV           DSA PAGES AVAILABLE                          STOR   
        #DSIZ           TOTAL DSA SIZE                               STOR   
        #DSTO           DSA AVAILABLE STORAGE                        STOR   
        #ESAV           EDSA PAGES AVAILABLE                         STOR   
        #ESIZ           TOTAL EDSA SIZE                              STOR   
        #ESTO           EDSA AVAILABLE STORAGE                       STOR   
        #PROC           TRANS PROCESSED              (IDENTIFIER)    WKLD   
        @ACBN           VTAM ACB Closed                              GENL   
        @CMXT           CLASS MAX TASK %                             TASK   
        @DB2N           DB2 Not Attached                             GENL   
        @ELAP           AVG ELAPSED TIME             (IDENTIFIER)    WKLD   
        @GLBD           CICS TD DFHINTRA USED %                      GENL   
        @GLBE           CICS EXT-PRIVATE USED %                      GENL   
        @GLBM           CICS TS MAIN IN USE                          GENL   
        @GLBP           CICS PRIVATE STG USED %                      GENL   
        @GLBT           CICS TOTAL CPU %                             GENL   
        @GLBU           CICS USER CPU %                              GENL

2. In the CMD field next to the service that you want to start, type S and press Enter.

   Depending on the type of monitor that you select, a monitor-specific dialog is displayed. The following figure shows an example of a workload dialog display.

   Start Workload Monitor dialog

                            Start Workload Monitor
    COMMAND ===>                                              SCROLL ===> CSR
                                                                       MORE: +
                           #PROC - TRANS PROCESSED
    Monitor Attributes:
    PARM                  (Identifier)       START          (hh:mm:ss)
    INTERVAL 00:01:00     (hh:mm:ss)         STOP           (hh:mm:ss/mins)
    WVAL                  (Warning value)    WIF   1        (Intvls to 1st msg)
    WMSG                  (Log warnings to)  WIN   1        (Message Intervals)
    WLIM     10           (Warnings limit)   RST   HOT      (HOT,PUR,QIS)
                                             QIS   YES      (YES/NO)
    TITLE   TRANS PROCESSED
    PLOTMAX                              (Maximum PLOT X-Axis value)
    RANGES                               (1-4 Range Distr. Upper Limits)
    LOG                                  (NO,ATSTOP,ATPD,ATINTVL,ATWARN)
   
    Specify Workload Selections:
     TRAN
     PROG
     TERM
     USERID
     CLASS
     PGMTYPE                         (NOATI, NOPRT or Program Type)
   
    Specify Workload Exclusions (Exclude even if match above selections)      
     TRAN                                                                     
     PROG                                                                     
     TERM                                                                     
     USERID                                                                   
     MORE    N   (Y/N,*-processed)

3. Specify the monitor service criteria:

   Field	Description	Default
   PARM	unique name for the request or a parameter for the monitor For more information about the monitor that you want to start, see Monitor reference	blanks
   START	when to start the monitor service	next full minute
   INTERVAL	time interval between successive service invocations	not applicable
   STOP	when to stop the monitor service	24 hours
   WVAL	warning threshold for the monitor request	0, no warnings
   WIF	number of intervals before the first warning message	1
   WMSG	where the warning messages are to be sent	LOG
   WIN	number of intervals between warning messages	1
   WLIM	maximum number of warning messages (PTF BQI2598 applied) Valid values are -1 to 999. Entering a value of 0 causes this parameter to a use the default value of 10 warning messages. Entering a value of -1 implies no limit to the number of warning messages.	10
   RST	restart option to be used when a service is quiesced because of an inactive target region	HOT
   QIS	action to be taken when a target is not active	YES
   TITLE	display title for the monitor service (see Monitor request title)	name of the service
   PLOTMAX	maximum value to be shown on the X-axis boundary for a PLOT of this monitor request	not applicable
   RANGES	from one to four upper-range limit values for the PLOT range distribution	no range
   LOG	logging option specification for the monitor service	no logging
   Specify Workload Selections	criteria used to limit or filter monitor data collection to a specific part of the workload	not applicable

   For additional information about a field, press F1 for online Help.

4. Press Enter.

   The service monitor request is started.