CMF MONITOR APIs

CMF MONITOR provides four application program interfaces (APIs) to SMF records: CX10GVID, CX10XDQY, CX10XDRC, and CX10XDGS. The CX10GVID API accesses only records collected on a single system.

More information about the CX10GVID API is provided in Implementation of the CX10GVID API.

The other APIs provide access to SMF records across a sysplex.

CX10XDQY queries buffered SMF data throughout the sysplex for any SMF record types.
CX10XDRC requests buffered SMF data from the sysplex based on the results from the CX10XDQY query.
CX10XDGS requests snapshot data throughout the sysplex using SMF type 79 records by invoking the CX10GVID API on the requested system or systems.
CX10XDRS supports API calls for Db2 z/OS metrics and SDSF - Job Delay information.

These APIs constitute CMF MONITOR’s Cross-System Data Server (XDS). All records obtained with XDS are available for use by the CMF Analyzer, CMFMON (for batch reports), and other performance tools. In addition, XDS provides access to SMF data for application programs, and provides values to the SDSF DA screen if you are using SDSF version 1.5 or later in SYSNAME mode.

Note

If you are using a version of SDSF earlier than 1.5 or if you are using nonsysname mode, SMF data is accessed by means of the CX10GVID API.

How XDS works

Like the CMF Extractor, XDS collects and stores SMF records. Unlike the Extractor, these records are stored in a data space buffer, which is accessible to CALLs from other systems in the sysplex.

While the CMF Extractor writes only type 70-78 and type 240 records to SMF or CMF data sets, XDS can buffer and return record images for all SMF record types or for any subset that you specify.

Application programs that are written to use the RMF APIs (ERBDSQRY, ERBDSREC, ERB2XDGS) can also use the CMF APIs without modification.

Activating XDS

XDS is activated with the XDS parameter in the MVS PAS PROC.

The default value of this parameter as distributed in XDS=00.

To disable XDS

Specify XDS=STOP or remove the XDS parameter from the PAS.

To activate XDS

Specify XDS=xx, where xx matches the suffix of a hilevel.BBPARM member CMFXDSxx.

Specifying XDS=01 accesses member CMFXDS01, which is one of the sample members provided in hilevel.BBPARM.

Access to data gathered by XDS

You can access data gathered by XDS for any systems within a sysplex, when all of the following conditions exist:

An MVS PAS is running in CPM mode with DC=START and XDS=nn on the system that you are currently using.
The XDS parameter member specifies the data that you want to be able to access.
An MVS PAS with the XDS parameter set is also running on the systems from which you want to access XDS data.
The CAS on each system is defined to join the same XCF group (the default).

This data can be used by the CMF Analyzer and by CMFMON to generate batch reports for data across multiple systems in the sysplex, as long as TYPE=NONE is not specified.

Specifying the source of input data

Perform these steps to specify the source of data input.

To specify the source of input data

Select Option 1 on the main menu for producing Analyzer reports.
Specify XDS in the SOURCE OF INPUT DATA field.
If you are setting up your own JCL, the Analyzer automatically uses data that is collected by XDS, if XDS is available and the //EXTDATA DD statement is not present.