Generating buffer pool reports

You can generate a database buffer pool report by running a batch buffer pool report job. Sample JCL, which is shown in the following figure, is included in the SBPLSAMP library in member BPLMAIN.

Figure 1. Sample JCL for running the batch buffer pool report job

//BPLMAIN  JOB
//*
//* This job runs the IMS Buffer Pool Analyzer buffer pool report.
//*

//  SET  SBPLLINK=BPL140.SBPLLINK   SBPLLINK DSN
//  SET  TRACE=BPL.TRACE                TRACE DSN
//  SET  ITKBSRVR=                      OPTIONAL ITKB SERVER NAME
//*
//* Any number of GTF trace data sets can be included in each
//* run of the reporting utility. Each GTF trace data set must
//* be allocated to a DD statement that begins with DDNAME TRACE. If 
//* there were three GTF trace data sets, a report run could
//* include DDNAMES TRACE1, TRACE2, and TRACEXYZ.
//*
//BPL     EXEC PGM=BPLMAIN,REGION=64M,PARM='ITKBSRVR=&ITKBSRVR'      
//STEPLIB  DD  DSN=&SBPLLINK,DISP=SHR 
//SYSPRINT DD  SYSOUT=*
//GTFRPT   DD  SYSOUT=*
//SPLRPT   DD  SYSOUT=*
//MDLRPT   DD  SYSOUT=*
//DBDRPT   DD  SYSOUT=*
//DSNRPT   DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//TRACE    DD  DSN=&TRACE,DISP=SHR 
//DVSVSAMP DD  DUMMY
//SYSIN    DD  DUMMY

The following symbolic parameters are defined in the sample job:

SBPLLINK: The SBPLLINK symbolic parameter sets the data set name of the IMS Buffer Pool Analyzer load library used in the STEPLIB DD.
TRACE: The TRACE symbolic parameter can be used to set the data set name of one trace data set. Since multiple data sets can be used as input to a report, other trace data sets should be added to the JCL using additional DD names that start with TRACE. Note that trace data sets cannot be concatenated to a single DD name.
For other considerations, see Combining multiple traces into a single report.
ITKBSRVR: The ITKBSRVR parameter can optionally be used to set the XCF group name for the IMS Tools Knowledge Base servers on the LPAR where the report job will run. If IMS Tools Knowledge Base is not used in your installation, or if you do not want to write IMS Buffer Pool Analyzer reports to the Knowledge Base repository, leave this symbolic parameter blank.

Following are the DD names that are included in the JCL for the Buffer Pool report:

STEPLIB: Required DD statement that must refer to a data set that contains the IMS Buffer Pool Analyzer load modules. The library does not require APF authorization for any batch report jobs.
SYSIN: Optional DD that you can use to specify reporting options. SYSIN control statements are described next.
SYSPRINT: Print output file for error messages and SYSIN control statements This is a required DD statement. The DCB information for this DD, which need not be specified, is RECFM=FBA,LRECL=133.
GTFRPT: Print output file for the GTF trace report. This is an optional DD statement; if this DD statement is not present, the GTF trace report is not produced. DCB information need not be specified, but it is RECFM=FBA,LRECL=133.DSORG=PS.
SPLRPT: Print output file for the Database Buffer Subpool reports. This is an optional DD statement; if this DD statement is not present, the database buffer subpool report is not produced. DCB information need not be specified, but it is RECFM=FBA,LRECL=133.DSORG=PS.
MDLRPT: Print output file for the model subpool reports if an alternate configuration was requested in a DFSVSAMP DD statement or a CHANGE DBD statement in the SYSIN DD. This is an optional DD statement; if this DD statement is not present, the model subpool report is not produced. DCB information need not be specified, but it is RECFM=FBA,LRECL=133.DSORG=PS.
DBDRPT: Print output file for the Database Information report. You can disable this report by specifying the SYSIN statement DBDRPT=NO. This is an optional DD statement; if this DD statement is not present, the database information report is not produced. DCB information need not be specified, but it is RECFM=FBA,LRECL=133.DSORG=PS.
DSNRPT: Print output file for the Data Set Information report. You can disable this report by specifying the SYSIN statement DSNRPT=NO. This is an optional DD statement; if this DD statement is not present, the Data Set Information report is not produced. DCB information need not be specified, but it is RECFM=FBA,LRECL=133.DSORG=PS.
SYSUDUMP: Diagnostic information. If an abend occurs, this information can be useful for troubleshooting the cause.
TRACExxx: Any number of TRACExxx DD names can be included in the report job. The last three characters of the DD name can be any valid characters that are allowed in JCL. Each DD name must have only one GTF trace data set. All data sets are read and combined for reporting purposes. At least one TRACExxx DD statement is required.
For other considerations, see Combining multiple traces into a single report.
DFSVSAMP: Optional DD that you can use to specify an alternate configuration to model. When this DD is specified, this data set must contain IMS buffer pool definition statements as described in the IMS System Definition.