CACHEACT

The CACHEACT control statement causes the Analyzer to generate reports by using the SMF type 74-5 records that are generated by the CACHE Extractor control statement.

CACHEACT
[REPORT={OVERVIEW|SUBSYS|DEVICE}]
[,MODEL={ALL|3990-03|3990-06|2105-20}]
[,ORDER={TOTAL|DASD|CACHE|ASYNC }]
[,SUBSYS=(xxxx[:xxxx]1,…,xxxx[:xxxx]16)]
[,DEVICE=(xxxxx[:xxxxx]1,…,xxxxx[:xxxxx]16)]
[,EXCLUDE=(xxxxx[:xxxxx]1,…,xxxxx[:xxxxx]16)]
[,THRESHLD=xxxxxxxxxx]

Related topics

Report-control-statements-Analyzer

CACHE

Cache-Subsystems-Overview-Report

Cache-Subsystem-Activity-Report

Cache-Device-Activity-Report

The following reports can be produced:

  • Cache Subsystem Overview Report

    This report contains a line of summary data for each cache subsystem, and a single page showing the DASD device activity. The last report page lists the most active DASD devices, by total and DASD I/O rates, and can have a variable number of lines, since filtering options and lack of device activity affect this section of the report. This report is the default.

  • Cache Subsystem Activity Report

    This report contains detail data about every cache subsystem. For each subsystem, the report shows one page of detail information for the subsystem, plus one or more pages of summary data for every DASD device attached to that subsystem. These pages consist of one line per device, plus additional lines for RAID rank activity.

  • Cache Device Activity Report

    This report contains detail data about every cache subsystem and detail data about every logical DASD device attached to a subsystem. For each cache subsystem, this report generates one page of detail subsystem information, and one or more pages of detail device information, one device per page.

Best Practice

This report can be quite voluminous, so BMC Software suggests that you request it only for specific devices or ranges, or when troubleshooting cache subsystem problems.

Parameters

Parameters for this statement are as follows:

REPORT=

Specifies the type of report to generate, as follows:

  • OVERVIEW—produces the default Cache Subsystem Overview Report
  • SUBSYS—produces the Cache Subsystem Activity Report
  • DEVICE—produces the Cache Device Activity Report

If not specified, the value will default to OVERVIEW

MODEL=

Generates a report on particular cache subsystems by model ID:

  • ALL—reports all models; the default
  • 3990-03—reports only model 3990-03 subsystems
  • 3990-06—reports only model 3990-06 subsystems
  • 2105-20—reports only model 2105 and 2107 subsystems

If not specified, the value will default to ALL.

ORDER=

Specifies the manner in which subsystems and devices in a report are ordered:

  • TOTAL—ordered by total I/O rates
  • DASD—ordered by DASD I/O rates
  • CACHE—ordered by Cache Hit rates
  • ASYNC—ordered by Async I/O rates

If not specified, the value will default to TOTAL.

SUBSYS=

Specifies a list of one or more subsystems or ranges of subsystems to be included in the reports

Up to 16 subsystems and subsystem ranges can be specified. Only specified subsytems will be included in the reports. All others will be excluded. If not specified, all subsystems will be included in the reports.

Any item in the list can be either a single subsystem ID (xxxx), or a range of subsystem IDs (xxxx:xxxx). They can appear in any combination and order.

DEVICE=

Specifies a list of one or more devices or ranges of devices to be included in the reports

Up to 16 devices and device ranges can be specified. Only specified devices will be included in the reports. All others will be excluded.

If not specified, all devices will be included in the reports. Any item in the list can be either a device number (xxxxx), or a range of device numbers (xxxxx:xxxxx). They can appear in any combination and order.

This parameter is ignored when REPORT=OVERVIEW is specified or is the default

EXCLUDE=

Specifies a list of one or more devices or ranges of devices to be excluded from the reports

Up to 16 devices and device ranges can be specified. Specified devices will be excluded from the reports. All others will be included.

If not specified, all devices will be included in the reports. Any item in the list can be either a device number (xxxx) or a range of device numbers (xxxx:xxxx). They can appear in any combination and order. If a device is specified in both the DEVICE= and EXCLUDE= lists, the former takes precedence.

This parameter is ignored when REPORT=OVERVIEW is specified or is the default.

Important

The SUBSYS, DEVICE and EXCLUDE parameters work in conjunction with each other as follows:

  • If SUBSYS is specified, only those devices on the specified subsystems will be filtered by the DEVICE and EXCLUDE parameters.
  • The DEVICE parameter takes precedence over the EXCLUDE parameter such that if the DEVICE parameter is specified, the EXCLUDE parameter is ignored.

THRESHLD=

This parameter establishes a threshold below which devices will be omitted from the report, which allows the user to reduce the volume of the report and concentrate on high-activity cache devices.

If specified, devices with total activity that falls below the threshold will be excluded from the report. The type of activity is determined by the ORDER parameter.

Specify as an integer value, 0 to (2GB - 1). This parameter is ignored when REPORT=OVERVIEW is specified or is the default.

Examples

The following examples illustrate the use of the CACHEACT control statement.

Example
CACHEACT

The Cache Subsystems Overview Report is produced.

Example
CACHEACT      MODEL=2105-20,REPORT=SUBSYS

The Cache Subsystem Activity Report is produced for 2105 and 2107 cache subsystems.

Example
CACHEACT      REPORT=DEVICE,
              DEVICE=(AC00:AC1F,C108),ORDER=DASD

The Cache Device Activity Report is produced for devices AC00 to AC1F, and device C108, for a total of 33 devices. The report is ordered in descending DASD I/O rate sequence.


 

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