Customizing the RMF control session

IBM provides the cataloged procedure, RMF, which is necessary to start z/OS® Data Gatherer. The procedure is stored in SYS1.PROCLIB(RMF), and you can modify it according to your requirements.

The RMF control session is the base for data gathering through the different monitors, especially for Monitor I, Monitor II. If you want to gather data with Monitor III, you also need the cataloged procedure, RMFGAT (see Setting up the Monitor III gatherer session RMFGAT).

This example shows the RMF procedure as supplied by IBM:

//IEFPROC   EXEC  PGM=ERBMFMFC,REGION=256M,
//          PARM=''

PARM

can be used for:

• Specifying the SMF buffer options to be used by the Sysplex Data Server. The format of this option is described in Controlling the SMF buffer. The defaults mean that specifying PARM='SMFBUF' is equivalent to:

  PARM='SMFBUF(SPACE(32M),RECTYPE(70:78))'

  You can override the values specified or defaulted here by using the SMFBUF option on the START RMF command when starting z/OS Data Gatherer.

• Providing automatic sysplex-wide management for the Distributed Data Server, PARM='DDS' (see Starting the Distributed Data Server in z/OS Resource Measurement Facility User's Guide).
• Specifying the Monitor I gatherer session options, for example, PARM='MEMBER(10),NOCACHE' (see Long-term data gathering with Monitor I).
• Activating sysplex-wide optimized coupling facility hardware data collection, PARM='CFOPT' (see Controlling sysplex-wide optimized coupling facility hardware data collection (CFOPT)).

z/OS Data Gatherer reads its ERBRMFxx members from the parmlib concatenation as defined in the LOADnn parmlib member, and then frees the data set in which they were found.

To have z/OS Data Gatherer read the ERBRMFxx members from a specific single data set, use a cataloged procedure in the following form:

//IEFPROC   EXEC  PGM=ERBMFMFC,REGION=256M,
//          PARM=''
//IEFPARM   DD    DSN=parmlibname,DISP=SHR

IEFPARM

Identifies the data set containing session options. If you specify an IEFPARM DD statement in the procedure, z/OS Data Gatherer does not use the logical parmlib concatenation.

To start the SMF data buffer on each system in your sysplex, store the procedure in the common proclib as follows:

//IEFPROC   EXEC  PGM=ERBMFMFC,REGION=256M,
//          PARM='SMFBUF'