CACHE

The CACHE control statement causes the CMF MONITOR 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{)}

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 MONITOR, 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 MainView for z/OS.

Parameters

The parameter for the CACHE control statement is:

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 MONITOR 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 MONITOR versions prior to 5.8, they are ignored and a warning message is issued.

Examples

Example

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

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

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

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

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

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

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