About CPM control statement members
The z/OS PAS startup procedure contains a CPM parameter that points to a control statement member that defines the operating conditions and data you want the
CMF MONITOR
Extractor and the system data collectors to use for CPM monitoring mode. The default control statement member is CMFCPM00.
To use a control statement member other than CMFCPM00
- Create a member by the name of CMFCPM xx, where xx is a unique two-character alphanumeric suffix in hlq.UBBPARM (as created by customization).
- Specify the unique two-character suffix on the CPM parameter and enter a MODIFY command that points to the new member (see Controlling-z-OS-PAS-operation) or restart the z/OS PAS.
To define the new member so that it is read at z/OS PAS initialization, do one of the following actions:
- Copy the control statement member into the data set allocated by the DD name PARMLIB (hlq.UBBPARM by default).
- If you have an existing data set that contains the control statement member, concatenate that data set name to the data set allocated by the DD name PARMLIB. Your concatenation should look something like this example:
//PARMLIB DD DISP=SHR,DSN=<hlq>.CMFdsn
// DD DISP=SHR,DSN=<hlq>.UBBPARM
// DD DISP=SHR,DSN=<hlq>.BBPARMCMFdsn is a data set containing the desired CPM control statement member.
The CMFCPM00 default member was constructed during customization (see the Customizing-after-installation for more information). The control statements that are contained in CMFCPM00 vary, depending on the combination of products that you have installed.
For example, if you have MainView for z/OS, CMF MONITOR, or both installed, CMFCPM00 looks like the following example:***********************************************************************
* *
* SAMPLE CMF EXTRACTOR CONTROL CARDS FOR USE WITH THE *
* MAINVIEW for z/OS. *
* *
* THE SAMPLERS SPECIFIED BELOW REPRESENT THE MINIMUM SET *
* REQUIRED BY MAINVIEW for z/OS DATA COLLECTORS. *
* ADDITIONAL SAMPLER CONTROL STATEMENTS MAY BE ADDED AS *
* NEEDED TO SATISFY OTHER REPORTING REQUIREMENTS. *
* *
***********************************************************************
*
REPORT CPM,INTERVAL=QTR,RUNTIME=1440,SMFRECID=240,
GBLS=1000,CSA=100,SMF=NO,SYNCH=00
*
ASMDATA
CHANNEL
CPU SAMPLE=500
DEVICE SAMPLE=500,CLASS=DASD
DEVICE SAMPLE=1000,CLASS=TAPE,OFFLINE=YES
*ENQUEUE
PAGING SAMPLE=5000The statements shown in the example are described in the following table:
Statement
Description
REPORT
Sets global parameters for an Extractor run
- CPM specifies continuous (as opposed to intermittent) monitoring mode.
- INTERVAL=QTR specifies that data from the samplers is gathered every 15 minutes, on the quarter-hour.
- RUNTIME=1440 specifies the maximum number of minutes that CPM mode remains active.
- SMFRECID=240 specifies an identification for SMF records (if you choose to have the z/OS PAS CMF Extractor write SMF records).
When started with this version of CMFCPM00, the Extractor writes SMF data to the data sets that are specified on the CMFCPM1 and CMFCPM2 DD statements.
- GBLS=1000 specifies that the global sampler should gather data every 1000 milliseconds.
- CSA=100 specifies the amount of CSA required, 100K.
- SMF=NO specifies that this control statement member does not write SMF records.
- SYNCH=00 specifies that the recording interval is not synchronized.
ASMDATA
Collects auxiliary storage management data, including information about the I/O activity of page and swap data sets and Auxiliary Storage Manager (ASM) data constants
Because a value is not specified, the default value is used; data is collected at a rate of once per second.
CHANNEL
Collects channel path statistics from the channel path measurement table at the beginning and end of each recording interval
CPU
Collects CPU and CPU-dispatching data, including information about CPU wait, busy, and idle status, online and offline times, queue depth, and processor concurrency
SAMPLE=500 means CPU data is collected every 500 milliseconds (or every half second).
DEVICE
Measures DASD devices for busy and wait status, I/O activity, online and offline times, and volume activity
SAMPLE=500 indicates DASD devices are measured every 500 milliseconds (or every half second).
CLASS=DASD indicates the device type as DASD devices.
DEVICE
Measures tape devices for busy and wait status, I/O activity, online and offline times, and volume activity
SAMPLE=1000 indicates DASD devices are measured once per second.
CLASS=TAPE indicates the device type as tape devices.
OFFLINE=YES indicates that offline devices are sampled.
ENQUEUE
Usually collects activity on queuing conflicts
In CMFCPM00, however, this statement is commented out to allow you to run two copies of the CMF Extractor simultaneously. (Only one concurrently active copy of the CMF Extractor can monitor enqueue activity. This restriction does not affect your MainView for z/OS or CMF MONITOR data.) If you decide to use the z/OS PAS Extractor for production, be sure to remove the comment from this statement.
PAGING
Collects paging and swapping data
SAMPLE=5000 means paging and swapping data is sampled every 5 seconds.
Related topic