Getting the data you want

Most of the data for both the CMFMON online and write facilities is provided by CMF Type 79 API, which collects its data from MVS system control blocks.

However, a few of the 79 subtypes require additional support before they can be displayed online or written to a data set. This section describes these requirements. (For more information about CMF Type 79 API, see CMF Type 79 API.)

CMF Type 79 API

This topic describes CMF Type 79 API.

The CMF Type 79 application program interface (API) provides an interface to SMF type 79 records for use by CMFMON and other performance tools.

For example, SDSF 1.3.3 displays certain fields from SMF records 79-1 and 79-2 using the CMF Type 79 API. In addition, performance monitors, such as the IBM OMEGAMON product, have also adopted the CMF Type 79 API to display data concerning device utilization, page/swap data set activity, and channel path utilization.

For details about the CMF APIs, see Developing.

CMF Extractor requirements

Some 79 record subtypes require an active Extractor sampler to provide the data.

If you are planning to display any of the screens or code any of the control statements that are shown in the first column of the following table, make sure the corresponding sampler is active in CPM mode :

Screen/Statement	Data description	CMF sampler	Subtype
TRX	Transaction activity	WORKLOAD	79-255
DEV/DEVICE	Device activity	DEVICE	79-9
PGSPP	Paging data set activity	ASMDATA	79-11
IOQUEUE/IOQ	I/O queuing activity	IOQ	79-14

Data returned by these subtypes reflects activity that occurred during the current CMF recording interval. These fields are reset at the beginning of each interval.

XDS requirements

Displaying data from a remote system or displaying 79 subtype 15 records requires XDS to provide the data.

If you are planning to display remote system data or display the ILOCK screen, make sure the XDS data buffer is active. For more information, see Displaying-data-from-a-remote-system.

Additional ILOCK screen requirements

CMFMON displays ILOCK data from all systems. Therefore, XDS must be active on every system from which you want information, as well as on the local system.

The ILOCK screen has no data-gathering component. Instead, the retrieval of the IRLM data from the SMF data buffer is done by CMFMON.

Data collection is initiated by the operator who, at the console, issues the RUNTIMEO exit for one system in the sysplex by typing

F irlmid,RUNTIMEO

The command will be propagated automatically to all other systems.

When the SMF records are eventually written by the IRLMs in the data-sharing group, the reporter can fetch these SMF records (79-15) out of the XDS data buffer.

If you request ILOCK information and receive the message that no data is available for the report, you need to ask the operator to issue the previously discussed command.

Important

Access to the SMF data buffer requires appropriate security authorization.

Other requirements

If you are running in a PR/SM or MDF environment, the Extractor CPU sampler must be active for the CMFType 79 API to report on system CPU utilization. If the CPU sampler is not active in a PR/SM environment, the API returns a value of -1 (x'FFFFFFFF') in field R793CPUU instead of CPU utilization data.