CACHE

The CACHE control statement causes the BMC AMI Ops Monitor for CMF Extractor to collect configuration and activity data for all or selected cache subsystems.

CACHE
[SUBSYS=(nnnn1,nnnn2,nnnn3,....nnnn16)]
[EXCLUDE=(nnnn1,nnnn2,nnnn3,....nnnn16)]
[RECORDS={(}CACHE,ESSLINK,ESSRANK,ESS,ALL{)}]
[D3990={YES|NO}]

(BMC.AMIOPS.SPE2207)

Monitoring modes	Only one CACHE statement can be defined for each monitoring mode, continuous (CPM) or intermittent (IPM). If more than one CACHE statement is specified, only the first statement will be accepted. All other statements are discarded. Specifying multiple CACHE statements does not adversely impact initialization of the PAS.
Sampler and record types	The CACHE statement controls the Cache/ESS sampler, which produces SMF type 74-5 and 74-8 records. As of version 5.6.00 of CMF, SMF 240-27 records are no longer produced.
Analyzer statements and reports	CACHEACT (for reports based on SMF type 74-5 records) ESS (for reports based on SMF type 74-8 records)	Cache Subsystem Overview Report Cache Subsystem Activity Report (when REPORT=SUBSYS is specified) Cache Device Activity Report (when REPORT=DEVICE is specified) ESS Statistics Report
	Note The ESS Statistics Report is created from SMF 74-8 records, which are created only if RECORDS=ESS, RECORDS=ESSLINK, RECORDS=ESSRANK, or RECORDS=ALL is specified on the CACHE control statement.
Other BMC Software products	The CACHE control statement must be defined in the Extractor JCL for BMC AMI Ops Monitor for z/OS.

Parameters

The following table lists the valid parameters for the CACHE control statement:

SUBSYS=	Specifies 1 to 16 cache subsystem IDs to be sampled
EXCLUDE=	Specifies 1 to 16 cache subsystem IDs to be excluded. For SUBSYS and EXCLUDE parameters, a cache subsystem ID is a four-digit hexadecimal string (for example, 03F5). When more than one subsystem ID is specified, they must be separated by commas and the entire string must be enclosed in parentheses. The SUBSYS and EXCLUDE are mutually exclusive. Either the SUBSYS or the EXCLUDE parameter can be specified, but not both parameters simultaneously. When both these parameters are omitted, CMF detects and monitors all active cache subsystems automatically.
RECORDS=	Specifies the cache sampler records that are created. Specify one or more of the following values. If you specify more than one value, separate the values with commas and enclose the value string in parentheses. CACHE—creates only cache records (SMF 74-5); the default ESSLINK—creates SMF 74-8 records containing ESS Link statistics ESSRANK creates SMF 74-8 records containing ESS Rank statistics and Extent Pool statistics ESS—creates SMF 74-8 records containing ESS Link statistics, ESS Rank statistics, and Extent Pool statistics, as appropriate with your system configuration; the same as ESSLINK and ESSRANK combined ALL—creates all possible records (that is, both SMF 74- 5 and SMF 74-8 records), as appropriate with your system configuration Note If you specify parameters that are only available in CMF versions prior to 5.8, they are ignored and a warning message is issued.
(BMC.AMIOPS.SPE2207) D3900=	Specifies whether to generate samplers and subtasks for all supported subsystems, or only the newer Cache subsystems Specify one of the following values: YES— (the default) generates separate samplers and subtasks for each of the supported Cache subsystems (3900-3, 3990-6, 2105, and any additional subsystems) NO— Eliminates the older 3990-3 and 3990-6 subsystems from processing. That is, CMF generates a Sampler and Subtask for the 2105 and newer Cache Subsystems.

Examples

Example 1

CACHE RECORDS=ALL

This example invokes the cache sampler and instructs it to collect both cache and ESS statistics (Link, Rank, and Extent Pool, as appropriate) from all detected cache and ESS systems.

Example 2

CACHE RECORDS=CACHE

This example invokes the cache sampler and instructs it to collect only cache statistics from all of the cache subsystems detected. No ESS statistics will be gathered.

Example 3

CACHE

This example invokes the cache sampler with no RECORDS parameter, which will cause the cache sampler to assume the default RECORDS=CACHE parameter and therefore collect only cache statistics from all of the cache subsystems detected. No ESS statistics will be collected.

Example 4

CACHE SUBSYS=(CF00,0B00)

This example invokes the cache sampler and instructs it to sample just two cache subsystems--CF00 and 0B00. As no RECORDS parameter is specified, the cache sampler assumes the default RECORDS=CACHE.

Example 5

CACHE RECORDS=ESS

This example invokes the cache sampler and instructs it to collect only ESS statistics from all of the ESS subsystems detected; no cache statistics will be gathered.

Example 6

CACHE RECORDS=(CACHE,ESSLINK)

This example invokes the cache sampler and instructs it to collect cache statistics and ESS Link statistics; no ESS Rank statistics will be gathered.

Example 7

CACHE EXCLUDE=(0A00,0D01)

This example invokes the cache sampler and instructs it to exclude the two cache subsystems, 0A00 and 0D01. All other available subsystems are sampled. As no RECORDS parameter is specified, the cache sampler assumes the default RECORDS=CACHE.

CACHE

Parameters

Examples

On this page