CMF record mapping

The CMF MONITOR Extractor and the CMFMON Write Facility create SMF records. You can also use these records to write your own reports.

These records match the type 70-79 records defined in the IBM System Management Facilities (SMF) manual. They are supplemented by the CMF user records. All of these records are used by the CMF Analyzer, the MXG program product, and the MICS program product. You can also use these records to write your own reports.

In addition, CMF MONITOR produces SMF user records with a default type of 240. CMF MONITOR produces approximately 25 record subtypes.

The member name for any record subtype is as follows:

Format	Member name
Assembler	CMFRECxx
C	CMFCxx
SAS	CMFSKxx
where xx is equivalent to the record subtype of 00 through 69

Data area maps for SMF type 7 x records are also available in BBSAMP members CMFSMFxx.

Refer to the hilevel.BBSAMP data set for data area maps for each of the CMF 240 user record subtypes.

This topic discusses how to use members in the CMF MONITOR BBSAMP data set to map record formats created by CMF, as well as SMF record types 70-79. This topic lists the CMF user record types that version 10.10 of Merrill Consultants’ MXG supports.

CMF MONITOR provides enhanced hilevel.BBSAMP members that contain improved format information about CMF MONITOR’s unique CMF user records, as well as SMF record types 70-79. The SMF type 70-79 record information in BBSAMP is provided in Assembler MACRO format.

CMF MONITOR provides a default SMF ID of 240 for its user records, but a different value could have been defined at the SMFRECID= parameter on the Extractor REPORT control statement.

The user record information in BBSAMP is provided in these three formats:

Assembler MACROs
C Structures
SAS code

Assembler MACROs in BBSAMP for record types 70-79

IBM 370/ESA assembly language MACROs, which are included in BBSAMP, map SMF record types 70-79. These MACROs replace the equivalent RMF MACROs in your programs.

CMFSMF7x	replaces ERBSMF7x, where x is the final digit of the SMF record type

Note

Make sure that you specify a binary file transfer, since the file is already in PC format in BBSAMP.

These MACROs are used by CMF code. The labels generated will not be identical to the labels generated by the RMF MACROs.
Best Practice
BMC Software recommends that you modify your existing programs to use the new MACRO names and the CMF-style labels.
Alternately, you can add the parameter labels=rmf to the MACRO to generate RMF-compatible labels.
These MACROs, by default, require HASM version 2 to compile. If you need to use Assembler XF or HASM version 1, you must add the parameter asm=xf to the MACRO.

Assembler MACROs in BBSAMP for user records

z/OS assembly language and the MACROs are included in BBSAMP map CMF user records. Two of the members provide the product section and record header information for all CMF user records.

CMFRECxx	where xx is the user record subtype
CMFRECCV	an internal MACRO for using the assembly language MACROs
CMFRECHD	the header format for all user records
CMFRECPR	the CMF MONITOR product section

C structures in BBSAMP

C structures are included in BBSAMP, which map CMF user records. These structures reduce the need to translate IBM 370/ESA assembly language definitions (DSECTs) of CMF user records into C.

CMFCxx	where xx is the user record subtype
CMFCSAMP	a sample program that reads subtype 4 records This C member is intended to be used as a guide to show how to use any of the CMFCxx members to write your own programs for processing these records.

SAS code in BBSAMP

SAS code is included in the BBSAMP data set for reading CMF user records. This code reads CMF records and creates corresponding SAS data sets for further processing. This code reduces the need to translate IBM 370/ESA assembly language definitions (DSECTs) of CMF user records into SAS input statements.

CMFSxx	where xx is the user record subtype This member is used with its associated CMFSKxx member. Each CMFSKxx member contains the SAS code for the CMF xx user record subtype. Descriptions of all fields read from the xx record are contained in each member.
CMFSHD	the record header format for CMF user records This member contains SAS code for reading the standard record header used for all CMF record subtypes. It is always used for reading CMF records.
CMFSKxx	where xx is the user record subtype These members contain a list of the variables kept in each of the SAS data sets created for each of the CMF user record subtypes. Each member is used with its associated CMFSxx member.
CMFSML	sample JCL and SAS code for reading and analyzing CMF user records Instructions for using this job are contained in this member.
CSMAPSAS	SAS member, intended to be used as a guide for writing customized in-house reports about the common storage usage by jobs that are using the subtype-29 records The format of CMF MONITOR subtype-29 record data is documented in the BBSAMP member CMFREC29.

Using CMF user records with MXG

Merrill Consultants’ MXG version 10.10 product fully supports the CMF user record types shown in the table below.

CMF user record type	Record description	CMF Extractor statement	MXG data set name
240015-00	SRM constants, installation performance specifications, and Extractor control cards data	REPORT	CMFDEVIC CMFDOM CMFIPS CMFOBJ CMFPG CMFSRMC CMFEXTCC CMFEXTPG CMFEXTRT
240-01	CPU data	CPU	CMFCPUQ CMFCPUS
240-02	ASM data	ASMDATA	CMF02PSD
240-03	paging data	PAGING	CMF03PGS
240-05	device data	DEVICE	CMF05DDS CMF05TDS
240-06	Extractor summary data	EXTSUM	CMF06GDA CMF06JDS
240-09	ASM data	ASMDATA	CMFASMQ
240-20	TSO command summary record data	TSODATA	CMF20CCS CMF20CSS
240-21	TSO user summary record data	TSODATA	CMF21USS
240-29	common storage usage by jobs	CSMON	CMF29COS CMF29CJS CMF29CDS