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.

EXTSUM


The EXTSUM control statement causes the CMF MONITOR Extractor to sample data on CPU and channel busy status, paging, I/O activity, TSO transaction rate, workload status, and service allocation percentages.

EXTSUM
[JOBCLASS=(JC=class1,JD=description1,...,JC=class36,JD=description36)]
[,SRVCLASS=(SC=serviceclass1,SCP=period1,...,SC=serviceclass64,
SCP=period64)]
[,JES={NO|YES}]
[,COPIES={1|n}]
[,SAMPLE={1000|nnnn}]
[,SPINOFF={A|class|NO}]

Monitoring modes

An EXTSUM statement can be specified for CPM mode only; this statement is not valid for IPM mode.

Sampler and record types

The EXTSUM statement controls the EXTS sampler, which produces CMF type 240-06 and 240-07 user records.

Analyzer statements and reports

PERFSUM, PERFORM

Performance Summary Report

The Extractor Summary Report is produced only if the SPINOFF parameter is defined with a valid SYSOUT class in the EXTSUM statement. The SPINOFF parameter causes the CMF MONITOR Extractor to dynamically allocate a JES spin-off data set at the end of each recording interval, without disrupting the continuous sampling functions of the CMF MONITOR Extractor. From this spin-off data, the CMF MONITOR Extractor automatically produces the Extractor Summary Report for every recording interval and sends it to the specified SYSOUT.

However, the other parameters and the WORKLOAD control statement also affect the Extractor Summary Report. If JES=NO is defined in the EXTSUM statement, the Job Class Activity section of the Extractor Summary Report is not produced.

Other BMC Software products

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

Parameters

The parameters for the EXTSUM control statement are:

JOBCLASS=

specifies the job class queues to be monitored for activity and a description for each class to be reported in the Extractor Summary Report

You can specify a maximum of 36 classes and descriptions. Any class that is specified is reported separately on the Extractor Summary Report; all other classes are grouped together and described as OTHER. There are two values to define to the JOBCLASS parameter:

  • JC= name of the job class
  • JD= description of job class

    For every JC= value specified, a job class description up to 15 characters long can be specified. The description specified as the JD value is displayed on the Extractor Summary Report.

SRVCLASS=

specifies the service classes and periods to be monitored for the Extractor Summary Report and the Performance Summary Report

A maximum of 64 service classes can be specified. There are two values to define to the SRVCLASS parameter:

  • SC= name of the service class

    You can specify the name of the service class, or you can use an asterisk (*) as a wildcard character to specify multiple service classes that use a pattern. For example, if you have two batch service classes (say, BATNRML and BATHOT), you can define SC=BAT* to specify both of those service classes.

    Note

    You can specify a maximum of 64 service classes. If use of the asterisk wildcard includes more than 64 service classes, only the first 64 service classes appear on the report.

  • SCP= number of the service class period

    For every SC value specified, you can specify up to eight periods. If you do not specify SCP for a particular service class, all periods appear in the reports.

    The SRVCLASS parameter can be used within the same control statement as the PERFORM parameter.

JES=

specifies whether the job entry subsystem is to be sampled and controls whether the Job Class Activity section of the Extractor Summary Report is produced

The default is JES=NO.

For the Job Class Activity section of the Extractor Summary Report to be produced, this value must be defined as JES=YES, and the SPINOFF parameter must be defined with a valid SYSOUT class.

For JES2 sampling, code JES=YES.

For JES3 sampling, code JES=YES and make sure that the procedure for JES3INIT was assembled and linked during AutoCustomization or manual customization. If you have upgraded your JES3 release since you installed CMF MONITOR, you must reassemble the JES3INIT procedure to link to the new offsets. Use AutoCustomization or the instructions in the hilevel.BBILIB member @@YCH300 to reassemble the JES3INIT procedure.

COPIES=

specifies the number of copies of the Extractor Summary Report to be printed

You can specify up to 99 copies. The default is 1. This parameter is meaningful only if the SPINOFF parameter is defined with a valid SYSOUT class.

SAMPLE=

specifies the number of milliseconds between data gathering cycles

The default is 1000. The sample rate cannot be below 500 or over 9999.

SPINOFF=

specifies the SYSOUT class to be dynamically allocated for printing the Extractor Summary Report

You can specify any valid SYSOUT class. The default is A. The SPINOFF=NO parameter eliminates all spin-off reports but allows Extractor summary records (CMF type 240-06 user records) to be written and later summarized by the Analyzer.

Examples

Example
EXTSUM JOBCLASS=(JC=A,JD=PRODUCTION,JC=T,JD=TEST),
SPINOFF=D,COPIES=3

The CMF MONITOR Extractor monitors and reports on job classes A and T. D is the SYSOUT class allocated to print the Extractor Summary Report. Three copies of the report are printed at Extractor recording intervals specified on the REPORT control statement.

Job class A has a description of PRODUCTION, and job class T has a description of TEST.

Example
EXTSUM JOBCLASS=(JC=A,JD=PRODUCTION,JC=T,JD=TEST),
SRVCLASS=(SC=*,SCP=1234)

The CMF MONITOR Extractor monitors and reports on job classes A and T and the first 4 periods on all service classes (up to 64 service classes).

 

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