Adding changing and deleting monitor sets

The previous section described various ways that you can start MVScope, which automatically creates a monitor set and adds it to MSLIST.

Type of command	Views
Three-character line commands	MSLIST
Three-character primary commands	MSLIST (ADD command only) MSMONSET MSDIAG MSDPROF MSDCPU MSDIO

Using line commands to modify monitor sets

All administrative tasks that you want to perform on a monitor set can be executed from the MSLIST view by using three-letter commands, as shown in the following table:

Line command	Description
ADD	Defines a monitor set by using a previous definition as a template The ADD primary command can be used to define a monitor set with the MVScope default values.
CHAnge	Makes changes to a monitor set definition whose status is Ready
DELete	Deletes the monitor set
MONitor	Starts a monitor set whose status is Ready
STOp	Terminates sampling or analyzing for a monitor set whose status is Waiting, Sampling, or Analyzing

The administrative tasks that can be performed on a particular monitor set are determined by the monitor set’s status. The status of a monitor set, the description, and the actions that you can perform on that monitor set by way of line commands are shown in the following table:

Monitor Set Status	Description	Valid Line Commands
Ready	Newly created monitor set is ready to begin sampling.	ADD CHAnge MONitor DELete
Waiting	Sampling has been requested, but MVScope has not yet located the active job, or the job is not active.	ADD STOp DELete
Sampling	MVScope is sampling an active job or device.	ADD STOp DELete
Analyzing	MVScope is analyzing the completed samples.	ADD STOp DELete
Analyzed	Samples have been fully analyzed. The monitor set records are still in working storage in the PAS.	ADD DELete
Retained	Completed records are not in any historical file, but they will be kept in the PAS’s working storage for five data collector intervals.	ADD DELete
Filed	Records remain in the historical file where they can be viewed in historical mode.	ADD DELete
Dropped	Historical records have been discarded or are not online. They are not retained in the PAS’s working storage.	ADD DELete
Error	Sampling failed. Look at the diagnostic text in the MSMONSET or MSDIAG view before taking any action.	ADD DELete

Now, use the MSLIST view and line commands to create, change, and delete MVScope monitor sets.

Adding monitor sets manually

Use the following procedure to add the monitor sets manually:

Display the MSLIST view by doing one of the following actions:
- From EZMZOS, select Program and I/O Trace.
- From the Utilities section on the MSMONSET view, select Monitor Sets.
- On the command line of any BMC AMI Ops view, type MSLIST.
MSLIST is displayed, showing the attributes of MVScope monitor sets, similar to the following figure:
>W1 =MSLIST============SJSCC610=*========DDMMMYYYY==HH:MM:SS====MVMVS====D====5
Cmd Monitor Set      Status    Samp Sampled Traced Sampling   Sampling CPU I/
--- -----------      ------    Types Job      Device Date       Start     ct c
    MONITOR MVSPXS1 Analyzed CPU   MVSPXS1         15AUG2012 01:40:17   1
    MONITOR MVSPXS1 Analyzed CPU   MVSPXS1         15AUG2012 01:40:10
    MONITOR MVSGXD1 Analyzed CPU   MVSGXD1         15AUG2012 01:39:35   1
    MONITOR MASTER   Ready     CPU   MASTER
    Template Monset Ready     CPU
First, add a new monitor set by using the default parameters of the Template Monset monitor set:
Type ADD to the left of Template Monset.
The MVScope Add Monitor Set panel is displayed. The MVScope Add Monitor Set panel lets you create a monitor set based on the template’s default parameters.
-------------------------- MVSCOPE ADD MONITOR SET ------------------------
COMMAND ===>                                              SCROLL ===> PAGE

  Monitor Set:
  Type of Sampling: CPU                               (CPU HIS CPUIO IO)

Entities to Sample:
  Job Name:
Dev/Vol(s):

Device Range(s) from:        to:         from:        to:
Device Range(s) from:        to:

Sampling Parameters:
  Max Dur in Secs 60       Max Devs to monitor 100
  Max CPU Samples 600      CPU Samples/Sec     10
  Max I/O Samples 100      Max CCWs per I/O    25

END to exit saving changes
CANCEL to exit without saving changes
HELP to view related help
RESET to reset to initial data
Create a new monitor set called WEEKLY.
1. Change the Monitor Set name to WEEKLY, and change the Type of Sampling to CPU.
2. Type the job name *MASTER* and a device number or volume serial number (use PAGD27 for this example).You can also change the sampling parameters.
Increase the duration to 120 samples per second, and increase the maximum number of I/Os from 100 to 200.
Important
You can copy the example because you will not activate sampling of this job.
-------------------------- MVSCOPE ADD MONITOR SET ------------------------
COMMAND ===>                                              SCROLL ===> PAGE

  Monitor Set:      WEEKLY
  Type of Sampling: CPU                               (CPU HIS CPUIO IO)

Entities to Sample:
  Job Name:          *MASTER*
Dev/Vol(s):         PAGD27


Device Range(s) from:        to:         from:        to:
Device Range(s) from:        to:

Sampling Parameters:
  Max Dur in Secs 120      Max Devs to monitor 100
  Max CPU Samples 600      CPU Samples/Sec     10
  Max I/O Samples 200      Max CCWs per I/O    25

END to exit saving changes
CANCEL to exit without saving changes
HELP to view related help
RESET to reset to initial data
Press End or PF3 to save this monitor set.You should see the MSLIST view, showing your new monitor set in the Ready state.
>W1 =MSLIST============SJSCC610=*========DDMMMYYYY==HH:MM:SS====MVMVS====D====6
Cmd Monitor Set      Status    Samp Sampled Traced Sampling   Sampling CPU I/
--- -----------      ------    Types Job      Device Date       Start     ct c
    MONITOR MASTER   Ready     CPU   *MASTER*
    MONITOR MVSPXS1 Analyzed CPU   MVSPXS1         15AUG2012 01:40:17   1
    MONITOR MVSPXS1 Analyzed CPU   MVSPXS1         15AUG2012 01:40:10
    MONITOR MVSGXD1 Analyzed CPU   MVSGXD1         15AUG2012 01:39:35   1
    MONITOR MASTER   Ready     CPU   MASTER
    Template Monset Ready     CPU
Now add a monitor set based on an existing one.
If you need to, run the Installation Verification Program again (see Installing-MVScope) so that you will have a monitor set similar to your example.
Select a monitor set from MSLIST that is in an Analyzed or Filed state. Use the job BMVSLKV in this example.
Next to the selected monitor set, type ADD, as shown in the following figure:
>W1 =MSLIST============SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D===20
Cmd Monitor Set      Status    Samp Sampled Traced Sampling Sampling CPU I/
--- -----------      ------    Types Job      Device Date      Start     ct c
ADD BMVSLK2YYYYNOV18 Analyzed CPUIO BMVSLKV /0D06 18NOVYYYY 09:30:05 28 1
     BMVPCC3YYYYNOV18 Ready     CPU   PCAUTH                    00:00:00
     BMVPCC3YYYYNOV18 Filed     CPU   RASP            18NOVYYYY 09:26:48 15
     BMVPCC3YYYYNOV18 Filed     CPU   PCAUTH          18NOVYYYY 09:26:48 12
     Template Monset Ready     CPU
The MVScope Add Monitor Set panel is displayed, showing the parameters for the selected monitor set as shown in the following figure:
---------------------------- MVSCOPE ADD MONITOR SET ------------------------
COMMAND ===>                                              SCROLL ===> PAGE

Monitor Set:      BMVSLK2YYYYNOV1809:32:52
Type of Sampling: CPU                               (CPU HIS CPUIO IO)

Entities to Sample:
Job Name:       BMVSLKV
Dev/Vol(s):      0D06

Device Range(s) from:        to:         from:        to:
Device Range(s) from:        to:

Sampling Parameters:
Max Dur in Secs 60       Max Devs to monitor 100
Max CPU Samples 600      CPU Samples/Sec     10
Max I/O Samples 100      Max CCWs per I/O    25

END to exit saving changes
CANCEL to exit without saving changes
HELP to view related help
RESET to reset to initial data
You can change the job name, type of sampling, or other parameters.
On the command line, type CANcel to redisplay MSLIST.
Because you have already seen how to add a new monitor set, now you will learn to change a monitor set.

Changing an existing monitor set

This section shows you how to modify a monitor set for a job that has not yet been run.

In this example, BMVSLKV is in the Ready state, and you want MVScope to monitor additional devices.

To monitor additional devices

Next to the monitor set, type CHA (first three letters of CHAnge), as shown in the following figure.
>W1 =MSLIST============SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D===20
Cmd Monitor Set      Status    Samp Sampled Traced Sampling Sampling CPU I/
--- -----------      ------    Types Job      Device Date      Start     ct c
CHA BMVSLK2YYYYNOV18 Ready     CPUIO BMVSLKV /0D06            00:00:00
     BMVSLK2YYYYNOV18 Analyzed CPUIO BMVSLKV /0D06 18NOVYYYY 09:29:05 12 2
     BMVPCC3YYYYNOV18 Ready     CPU   PCAUTH                    00:00:00
     BMVPCC3YYYYNOV18 Filed     CPU   RASP            18NOVYYYY 09:16:48 15
     BMVPCC3YYYYNOV18 Filed     CPU   PCAUTH          18NOVYYYY 09:16:48 12
     Template Monset Ready     CPU
The MVScope Change Monitor Set panel is displayed, as shown in the following figure. From this panel, you can change any of the parameters or the sampling type, and add devices.
Make these changes to the monitor set:
1. Add several devices in the Dev/Vol(s) field, such as 217, 3A01, 322, and BAB314.
  Important
  You must prefix device addresses with the slash character (/) to distinguish them from a volume serial number.
2. Add a Device Range from 300 to 320.
  ----------------------- MVSCOPE Change MONITOR SET -----------------------
  COMMAND ===>                                              SCROLL ===> PAGE
  
  Monitor Set:      BMVSLK2YYYYNOV1813:09:36:34
  Type of Sampling: CPU                               (CPU HIS CPUIO IO)
  
  Entities to Sample:
  Job Name:       BMVSLKV
  Dev/Vol(s):        0D06        /217        /3A01        /322        BAB314
  
  Device Range(s) from: 300    to: 320     from:        to:
  Device Range(s) from:        to:
  
  Sampling Parameters:
  Max Dur in Secs 120      Max Devs to monitor 100
  Max CPU Samples 600      CPU Samples/Sec     5
  Max I/O Samples 200      Max CCWs per I/O    25
  
  END to exit saving changes
  CANCEL to exit without saving changes
  HELP to view related help
  RESET to reset to initial data
  You can change the parameters of the monitor set, such as adding devices, increasing the sampling time or number of samples, and reducing the number of samples per second.
Press End or PF3 to return to MSLIST.MVScope gives you warning messages; two of the devices added to the monitor set are unavailable, as shown in the following figure. Either they are offline, or they do not exist on your system. MVScope will still monitor the job, but the results will not contain information about the two missing devices.
>W1 =MSLIST============SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D==20
BBDMBM19W Device 0217 is currently unavailable
BBDMBM19W Device 3A01 is currently unavailable
To clear the warning messages, press Enter.

Deleting monitor sets

To delete a monitor set that is in any state, use the DELete line command in the MSLIST view.

In the example shown in the following figure, you are deleting the monitor set for job PCAUTH, which was filed at 09:16:48 on November 18.

>W1 =MSLIST============SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D===20
Cmd Monitor Set      Status    Samp Sampled Traced Sampling Sampling CPU I/
--- -----------      ------    Types Job      Device Date      Start     ct c
     BMVSLK2YYYYNOV18 Ready     CPUIO BMVSLKV /0D06            00:00:00
     BMVSLK2YYYYNOV18 Analyzed CPUIO BMVSLKV /0D06 18NOVYYYY 09:30:05 12 2
     BMVPCC3YYYYNOV18 Ready     CPU   PCAUTH                    00:00:00
     BMVPCC3YYYYNOV18 Filed     CPU   RASP            18NOVYYYY 09:16:48 15
DEL BMVPCC3YYYYNOV18 Filed     CPU   PCAUTH          18NOVYYYY 09:16:48 12
     Template Monset Ready     CPU