Abstract for Resource Measurement Facility Programmer's Guide
Summary of changes
Summary of changes for z/OS RMF Programmer's Guide for Version 2 Release 1, as updated February 2015
z/OS Version 2 Release 1 summary of changes
SMF records
Overview
SMF record format
Archived performance data
RMF version numbers
Printing SMF records
Using the IDCAMS utility
Using the ERBSCAN utility
Obtaining SMF record data directly
Registers at entry
Parameter list contents
Output
Return codes
Coded example
RMF sysplex data services
How to call sysplex data services
How to call sysplex data services in 64-bit mode
ERBDSQRY - RMF Query available sysplex SMF data service
ERBDSREC - RMF Request sysplex SMF record data service
ERB2XDGS - RMF Monitor II sysplex data gathering service
ERB2XDGS data reduction exit routines
ERB3XDRS - RMF Monitor III sysplex data retrieval service
ERB3XDRS data reduction exit routines
Return codes and reason codes
Layout of RMF callable services answer area
Layout of common answer area header
ERBDSQRY/ERBDSQ64 data section layout
ERBDSREC/ERBDSR64 data section layout
ERB2XDGS/ERB2XD64 data section layout
ERB3XDRS/ERB3XD64 data section layout
Accessing performance data using the RMF Distributed Data Server
How to specify HTTP requests to the DDS for performance data
Understanding the underlying resource models
The z/OS RMF Monitor III resource model
The AIX resource model
The Linux on System x resource model
The Linux on System z resource model
The Windows on System x resource model
Structure of DDS requests
Description and purpose of parameters
The resource parameter
The id parameter
The range parameter
The filter parameter
The workscope parameter
The name parameter
The listtype parameter
The reports parameter
The date parameter
The duration parameter
The timeofday parameter
The sysid parameter
The overview parameter
The timeout parameter
How to specify different types of requests
How to specify a contained request
How to specify a details request
How to specify a detailsname request
How to specify a filterinst request
How to specify an index request
How to specify a listmetrics request
How to specify a perform request
How to specify a report request
How to specify a root request
How to specify a workscopes request
How to specify a postprocessor request
How to interpret an XML document returned by the DDS
Description of the XML document structure
Attribute-List element
Resource
Attribute
Message
Contained-Resources-List element
Contained
Filter-Instances-List element
Metric-List element
Metric
Report element
Time-Data
Caption
Row
Column-Headers
Workscope-List element
Postprocessor element
Metric-PP
Version-PP
Resource-PP
Time-Data-PP
Segment
Part
Var-List
Var
Table
Coding example for requesting and receiving Monitor III performance data
z/OS CIM monitoring
z/OS RMF CIM monitoring
z/OS resource classes based on RMF
IBMz_CEC
IBMz_ComputerSystem
IBMzOS_Channel
IBMzOS_WLMServiceDefinition
IBMzOS_WLMServiceClassPeriod
z/OS metrics
IBMzOS_LogicalDisk
IBMz_CEC
IBMz_ComputerSystem
IBMzOS_OperatingSystem
IBMzOS_ComputerSystem
IBMzOS_Process
IBMzOS_UnixProcess
IBMzOS_Channel
IBMzOS_UnixLocalFileSystem
Adding Monitor I and Monitor II installation exits
Overview
Monitor I session user reports
Guidelines
Caution
Initialization for Monitor I session user exit routines
Sampling data at each cycle
Interval processing
Report writing during session processing
Termination
Tracing your own field
Step 1 -- Defining the name to RMF
Step 2 -- Replacing ERBTRACE
Report writing by the Postprocessor
Adding your routines to RMF
Monitor II session user reports
Guidelines
SMF record type 79
Relocate blocks
Data control section
Coding a user report
Data gatherer
Data reporter
Installing a user report
Using the PICTURE macro
Example
TSO terminal user authorization
Adding Monitor III user exits
Overview
Data gathering
Reporting
Invoking user reports
Measurement data
Data gatherer sample structure
Data gatherer control blocks
Set of samples header control block (SSHG3)
Sample header control block (SHDG3)
Resource data record (REDG3)
User record
Programming a data gatherer
Data reporter phases
The Monitor III utility
Report utility panel flow
Before you start the utility
Starting the report utility
Example - Modified SYSINFO report
Report format definition panel (ERB3RD1)
Phase driver information panel (ERB3RD2)
Report format information panel (ERB3RD3)
Report header layout panels (ERB3RD4 and ERB3RD5)
Report subheader layout panels (ERB3RD6 and ERB3RD7)
Report column layout panels (ERB3RD8 and ERB3RD9)
Command line layout panel (ERB3RDA)
Graphic parameter definition panels (ERB3RDB, ERB3RDC, ERB3RDD)
Saving or cancelling changes on panel ERB3RDF
Deleting a user-defined report
Ending the report utility
Implementing the report
Special considerations for modifying reports
Installing your own phases
Phase 1
Phase 2
Phase 3
Phase 4
Data retrieval service (ERB3RDRS)
Programming considerations
Function codes
Registers at entry
Parameter area contents
Output
Return codes
TSO/E user authorization
Using Monitor III VSAM data set support
Data set record structure
Data set decompression
Programming considerations
Registers at entry
Parameter area contents
Output
Return codes
Coded example
Data set content
Monitor III data set record and table formats
ERBASIG3 - Address space identification table
ERBCATG3 - Cache data information table
ERBCFIG3 - Coupling facility information table
ERBCPCDB - CPC data control block
ERBCPDG3 - Channel data table
ERBCPUG3 - Processor data control block
ERBCSRG3 - Common storage remaining table
ERBDSIG3 - Data set header and index
ERBDVTG3 - Device table
ERBENCG3 - Enclave data table
ERBENTG3 - Enqueue name table
ERBGEIG3 - General information table
ERBGGDG3 - Global gatherer data table
ERBOPDG3 - OMVS process data table
ERBRCDG3 - Resource collection data
ERBREDG3 - Resource data record
ERBSHDG3 - Sample header
ERBSPGG3 - Storage group and volume data
ERBSSHG3 - MINTIME set of samples header
ERBSVPG3 - Service policy
ERBUWDG3 - USE/WAIT record
ERBXMHG3 - Moved samples header control block
Monitor III data reporter tables
Tabular report format table ERBFMTS3
Header data table ERBHDRS3
Monitor III data reporter tables
CACHDET - Tabular report data table ERBCADT3
CACHSUM - Tabular report data table ERBCAST3
CFACT - Tabular report data table ERBCFAT3
CFOVER - Tabular report data table ERBCFOT3
CFSYS - Tabular report data table ERBCFST3
CHANNEL - Tabular report data table ERBCHAT3
CPC - Tabular report data table ERBCPCT3
Fields in the CPC report header
DELAY - Tabular report data table ERBJDET3
DEV - Tabular report data table ERBDEVT3
DEVR - Tabular report data table ERBDVRT3
DI - Tabular report data table ERBDSIT3
DSND - Tabular report data table ERBDNDT3
DSNJ - Tabular report data table ERBDNJT3
DSNV - Tabular report data table ERBDNVT3
ENCLAVE - Tabular report data table ERBENCT3
ENQ - Tabular report data table ERBENQT3
ENQR - Tabular report data table ERBEQRT3
HSM - Tabular report data table ERBHSMT3
IOQUEUE - Tabular report data table ERBIOQT3
JES - Tabular report data table ERBJEST3
JOB - Tabular report data table ERBJDJT3
LOCKSP - Tabular report data table ERBLSPT3
LOCKSU - Tabular report data table ERBLSUT3
OPD - Tabular report data table ERBOPDT3
PROC - Tabular report data table ERBPRCT3
PROCU - Tabular report data table ERBPRUT3
RLSDS - Tabular report data table ERBVRDT3
RLSLRU - Tabular report data table ERBVRLT3
RLSSC - Tabular report data table ERBVRST3
SPACED - Tabular report data table ERBSPDT3
SPACEG - Tabular report data table ERBSPGT3
STOR - Tabular report data table ERBSTRT3
STORC - Tabular report data table ERBCSUT3
STORCR - Tabular report data table ERBCRST3
STORF - Tabular report data table ERBSTFT3
STORM - Tabular report data table ERBSTMT3
Fields in the STORM report header
STORR - Tabular report data table ERBSRRT3
STORS - Tabular report data table ERBSRST3
SYSENQ - Tabular report data table ERBEQST3
SYSINFO - Tabular report data table ERBSYST3
Fields in the SYSINFO report header
SYSRTD - Tabular report data table ERBRTDT3
SYSSUM - Tabular report data table ERBSUMT3
SYSWKM - Tabular report data table ERBWKMT3
WFEX - Tabular report data table ERBWFXT3
XCF - Tabular report data table ERBXCFT3
ZFSSUM - Tabular report data table ERBZFST3
ZFSACT - Tabular report data table ERBZFAT3
Graphic report parameter table ERBPTGS3
RMF Phase driver table ERBPHDS3
Diagnosing problems in RMF
Identifying problems
Diagnosing abend 0D5
Diagnosing abend 0FE
Diagnosing an abend unexpected by RMF
Diagnosing a message with an ERB prefix
Diagnosing a message with a CEE/EDC prefix
Diagnosing incorrect output
Diagnosing a documentation error
Diagnosing an empty Monitor III JES Delays report
Obtaining a dump from Monitor II or Monitor III
Developing a search argument for RMF
Reporting a problem to IBM