z/VM: CP Commands and Utilities Reference - z/VM - IBM

MONITOR SAMPLE
1. Any overlapping of I/O devices can exist on a series of MONITOR SAMPLE
commands on the I/O domain. For example, if the command:
monitor sample enable i/o type 3380
is followed by:
640 z/VM: CP Commands and Utilities Reference
monitor sample enable i/o class dasd
all DASD are enabled for monitoring. If the command is then followed by:
monitor sample disable i/o type 3380
monitoring ceases for all 3380 devices, but continues for all other types of
DASD.
2. A message is issued for any specified device that does not exist.
3. Devices that are enabled but are found to be offline are monitored when varied
online. A summary message is issued indicating how many devices are enabled
for monitoring, and how many are offline.
4. The VOLUME operand can be used only for volumes attached to the system,
because CP associates a volume label to a device number only at the time it is
attached. If it is desired to enable a DASD not attached to the system, it can be
done by using the DEVICE option.
5. The volume to be monitored is maintained by its device address. Enabling or
disabling a volume for monitoring remains valid as long as its device address
does not change. For example, if a volume is detached and a volume with the
same label at a different address is attached, the volume must be enabled
again to be monitored, and its previous device address disabled.
6. A cache data record will not be created for a secondary device of a duplex pair.
Specific Usage Notes for INTERVAL:
1. The valid range of values for INTERVAL is 6 to 3600 for SECONDS, and 1 to
60 for MINUTES. INTERVAL values must be specified in whole numbers.
2. The default value of INTERVAL is one minute (60 seconds).
3. If an interval is currently in effect, the new interval does not take effect until the
next sample data record is produced.
4. The SAMPLE INTERVAL value must be greater than or equal to the SAMPLE
RATE value.
5. It is possible that data may not be reported by the time the interval expires. This
happens when it takes longer than an interval to collect the data. If this
happens, the interval time should be adjusted to allow sufficient time to collect
and report the data.
Specific Usage Notes for RATE:
1. The valid range of value for RATE is .01 to 30 seconds. As many as two digits
may be specified after the decimal point. Leading zeros are not required, and
trailing zeros are not required after the decimal point.
2. The default value of RATE is two seconds.
3. If a rate is currently in effect, the new rate does not take effect until the current
high-frequency rate has elapsed.
4. The SAMPLE RATE value specified must be less than or equal to the SAMPLE
INTERVAL value.
5. The frequency of doing high-frequency sampling is determined by the RATE
setting, however the creation of monitor records containing high-frequency data
is controlled by MONITOR SAMPLE INTERVAL.
Specific Usage Notes for CONFIG SIZE: