Defining Extractor control statements
This topic discusses the default Extractor control statement sets for both CPM and IPM modes that are shipped with CMF MONITOR.
During AutoCustomization or manual customization, Extractor control statement members for both CPM and IPM were customized to your site requirements. If you want to change or create additional control statement members, you can use the default members in hilevel.UBBPARM as a starter set of statements. However, any members that you create must follow this specific naming convention:
- for CPM mode, members must be named CMFCPMxx
- for IPM mode, members must be named CMFIPMxx
where xx is a unique two-character identifier.
Default CPM and IPM control statement sets
The hilevel.UBBPARM data set contains two sample Extractor control statement members that comprise a starter set for initial execution of the CMF MONITOR Extractor.
CMFCPM00 | invokes a CPM monitor that runs continuously, sampling most functions |
|---|---|
CMFIPM00 | invokes an IPM monitor that runs for 60 minutes, sampling most functions valid in the IPM mode |
Using the CMFCPM00 control statement set
CMFCPM00 invokes the CPM monitor, which runs continuously.
(For more information, see When to use CMF MONITOR Extractor CPM and IPM modes.) Records are written to the Extractor data set every 15 minutes. The CMF user record ID is 240 (X'F0'). Records are written to SMF, because SMF=YES is specified on the REPORT control statement.
Sample control statements in CMFCPM00 are shown in Extractor control statements in starter set in the following figure.
* *
* STARTER CONTROL STATEMENTS FOR THE EXTRACTOR IN CPM MODE *
* *
* USE THIS MEMBER WHEN THE FOLLOWING PRODUCT IS RUNNING BY ITSELF *
* IN CPM MODE: *
* *
* - CMF MONITOR *
* *
* WHEN YOU ARE READY TO PLACE YOUR PRODUCTS INTO A PRODUCTION *
* ENVIRONMENT AND RMF IS NOT PRESENT, YOU MAY WANT TO MAKE SOME *
* OF THE FOLLOWING CHANGES TO THE CONTROL STATEMENTS: *
* *
* 1. TO WRITE RECORDS TO THE SMF DATA SET OR AN SMF LOG STREAM *
* (RATHER THAN TO CMF OUTPUT DATA SETS), CHANGE THE SMF= *
* PARAMETER ON THE REPORT CONTROL STATEMENT FROM SMF=NO TO *
* SMF=YES. *
* *
* 2. MODIFY THE EXTSUM CONTROL STATEMENT TO INCLUDE YOUR *
* INSTALLATION JOB CLASSES AND PERFORMANCE GROUPS. *
* *
***********************************************************************
* CHANGE LOG: *
* CREATED BY ?USER ON ?DATE AT ?TIME. *
* *
***********************************************************************
REPORT CPM,INTERVAL=15,SYNCH=00,CSA=512,SMFRECID=240,
RUNTIME=1440,SMF=NO
ASMDATA SAMPLE=2000
***********************************************************************
* *
* THE CACHE CONTROL STATEMENT NEEDS TO BE INVOKED FROM ONLY *
* ONE SYSTEM IF ALL CACHE SUBSYSTEMS ARE SHARED. *
* *
***********************************************************************
CACHE
CFDATA
CHANNEL
CPU SAMPLE=2000
*CRYPTO
DEVICE SAMPLE=2000,CLASS=DASD
DEVICE SAMPLE=2000,CLASS=TAPE,OFFLINE=YES
***********************************************************************
* *
* THE MAJOR=SYSDSN PARAMETER SPECIFIES THAT ONLY RESOURCES HAVING *
* THE MAJOR NAME OF SYSDSN ARE MONITORED. YOU CAN CHANGE THE *
* VALUE OF THIS PARAMETER TO THE MAJOR NAME OF YOUR CHOICE OR YOU *
* CAN REMOVE THE MAJOR= PARAMETER TO MONITOR ENQUEUE CONTENTION *
* FOR ALL RESOURCES. *
* *
***********************************************************************
ENQUEUE MAJOR=SYSDSN
***********************************************************************
* *
* THE EXTSUM STATEMENT SHOULD BE MODIFIED TO MONITOR SPECIFIC *
* INSTALLATION JOB CLASSES. *
* *
***********************************************************************
EXTSUM SPINOFF=NO,JES=NO,SAMPLE=2000,
JOBCLASS=(JC=A,JD=CLASSA,
JC=B,JD=CLASSB)
*FICONSW
***********************************************************************
* *
* THE VSMDATA SAMPLER CAN HAVE HIGH CPU OVERHEAD. *
* *
***********************************************************************
VSMDATA SAMPLE=6000
WORKLOAD
XCFDATA
***********************************************************************
* *
* END OF CPM CONTROL STATEMENTS *
* *
***********************************************************************
CMFIPM00 control statement set
CMFIPM00 invokes an IPM monitor that runs for 60 minutes.
(For more information, see When to use CMF MONITOR Extractor CPM and IPM modes.) Records are written to the Extractor data set every 15 minutes. The CMF user record ID is 240 (X'F0'). Records are written to the data set defined by the //CMFIPM1 DD statement.
- To start the IPM monitor, either issue the MODIFY command, or specify DC=IPM on the MVS PAS PROC.
- To stop the IPM monitor, issue the MODIFY command IPM=STOP.
The following figure shows a sample set.
Extractor control statements in starter set CMFIPM00
* *
* CONTROL STATEMENTS FOR THE EXTRACTOR IN IPM MODE *
* *
* USE THIS MEMBER WHEN THE FOLLOWING PRODUCT IS RUNNING BY ITSELF *
* IN IPM MODE: *
* *
* - CMF MONITOR *
* *
***********************************************************************
* CHANGE LOG: *
* CREATED BY ?USER ON ?DATE AT ?TIME. *
* *
***********************************************************************
REPORT IPM,INTERVAL=15,CSA=512,SMFRECID=240,RUNTIME=60,SMF=NO
CACHE
CHANNEL
CPU SAMPLE=500
DEVICE SAMPLE=500,CLASS=DASD
DEVICE SAMPLE=500,CLASS=TAPE,OFFLINE=YES
IOQ
***********************************************************************
* *
* END OF IPM CONTROL STATEMENTS *
* *
***********************************************************************
Related topic