Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for CMF 6.3.

CPU

The CPU control statement causes the CMF MONITOR Extractor to collect CPU and CPU-dispatching data.

CPU
[SAMPLE={1000|nnnn}]
[,CAPMSG={YES|NO}]
[,CAPMSGRP={10|nn|NO}]
[,VMLPAR={YES|NO}]

This data includes information about CPU wait, busy, and idle status, online and offline times, queue depth, and processor concurrency.

Monitoring modes

One CPU statement can be specified for each monitoring mode, continuous (CPM) or intermittent (IPM).

Sampler and record types

The CPU statement controls the CPUS sampler, which produces SMF type 70-1 records and CMF type 240-01 user records.

Analyzer statements and reports

CMFSUM

CPU

CPUCON

PERFSUM, PERFORM

PROTKEY

SRM

TSOPERF TYPE=INT

CMF Summary Report

CPU Utilization Report

Processor Concurrency Report

Performance Summary Report

CPU Utilization by Protect Key Report

System Resources Manager Report

TSO Interval Summary Report

Other BMC Software products

The CPU control statement must be defined in the CMF MONITOR Extractor JCL for MainView for z/OS.

Parameters

The parameters for the CPU control statement are:

SAMPLE=

specifies the number of milliseconds between data-gathering cycles for CPU data

The default is 1000 milliseconds or one second. Acceptable values are 20 to 9999.

CAPMSG=

specifies whether the MVS PAS issues the message notifying that the local logical partition is soft-capped by WLM

If YES, the default, is specified, the MVS PAS issues the following message after detecting that the logical partition has been soft capped by WLM:

CMFCPU13 LPAR SOFT CAPPED BY WLM

When the logical partition is no longer capped, the following message is issued:

CMFCPU15 LPAR NO LONGER SOFT CAPPED BY WLM; CAPPED DURATION WAS hhh.mm.ss

Note

  • If the weight of the local logical partition represents a CPU capacity below the defined capacity, WLM needs to turn capping on and off to keep the short-term CPU usage at the defined capacity. In this scenario, the previously listed CMFCPU13 and CMFCPU15 messages are issued repeatedly, normally a few minutes apart but could be as short as 10 seconds apart. When hhh.mm.ss is relatively short, the logical partition might be soft-capped again soon.
  • The CPU sampler checks the capped status approximately every 10 seconds. When the message CMFCPU13 or CMFCPU15 is issued, the capped status has actually changed, on average, 5 seconds earlier.
  • This parameter is applicable only for CPM mode and is ignored if specified for the IPM mode.

CAPMSGRP=

specifies whether the MVS PAS issues the message notifying that the local logical partition remains soft-capped by WLM

If a value nn from 1 to 60 is specified (the default is 10), the MVS PAS issues the following CMFCPU14 message every nn minutes:

CMFCPU14 LPAR SOFT CAPPED BY WLM SINCE hh:mm:ss ddmmmyy FOR hhh.mm.ss

If NO is specified, the message CMFCPU14 is not issued.

Note

  • If CAPMSG=NO is specified, either omit this parameter or specify CAPMSGRP=NO.
  • This parameter is applicable only for CPM mode and is ignored if specified for the IPM mode.

VMLPAR=

specifies whether LPAR type data is collected from z/VM

If the CMF MONITOR Extractor is running in z/OS under z/VM and VMLPAR=YES is specified, the following happens:

  • The CPUS sampler collects virtual LPAR information from z/VM and writes it to the SMF type 70-1 records.

  • Analyzer CPU reports contain logical partition reports as if z/OS is running in an LPAR.

    The LPAR name is the VM user ID under which the virtual z/OS is running.

  • The LPAR data collector also collects this information and creates LPAR interval records that can be displayed in the various LPAR views.

The default value is NO, and when the CMF MONITOR Extractor is not running in z/OS under z/VM, this parameter is ignored.

Note

This parameter is applicable only on the CPU statement in a CMF CPM Monitor member (CMFCPMxx) and it automatically applies to both the CPM and the IPM modes.

Examples

Example
CPU

The CMF MONITOR Extractor samples CPU data once per second, using the default SAMPLE=1000.

Example
CPU  SAMPLE=1500

The CMF MONITOR Extractor samples CPU data once every 1 seconds.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*